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About this guide 



This guide describes HP StorageWorks Secure Path for Active-Passive disk arrays and Secure Path for 
Active-Active disk arrays. It provides information to help you: 

• Understand Secure Path technology. 

• Determine hardware and software prerequisites. 

• Install Secure Path software. 

• Manage Secure Path. 

W NOTE: 

Support for the HSG family of arrays ended with Secure Path for HP-UX 3. OF. Any references to support 
for those arrays applies to 3.0F and earlier releases. 



Overview 

This document describes the following: 

• Chapter 1 addresses Secure Path 3. OF SP2 for Active-Passive disk arrays, which includes: 

• HP StorageWorks disk array EVA3000 (HSVlOO) 

• HP StorageWorks disk array EVA5000 (HSVllO) 

• HP StorageWorks disk array MA6000 

• HP StorageWorks disk array RA8000 or MA8000 

• Chapter 2 addresses Secure Path 3. OF SP2 for Active-Active disk arrays, which includes: 

• HP StorageWorks disk array EVA3000 (HSVlOl) 

• HP StorageWorks disk array EVA4000/EVA6000 

• HP StorageWorks disk array EVA5000 (HSVlll) 

• HP StorageWorks disk array EVA8000 

• HP StorageWorks disk array XP48 

• HP StorageWorks disk array XP128 

• HP StorageWorks disk array XP256 

• HP StorageWorks disk array XP512 

• HP StorageWorks disk array XP1024 

• HP StorageWorks disk array XPIOOOO 

• HP StorageWorks disk array XP 12000 

Intended audience 

This guide is intended for system administrators who are experienced with the following: 

• Data processing and direct-access storage device subsystems and their basic functions. 

• Operating systems, including commands and utilities 

• Any of the storage system disk arrays described in Overview. 
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Related documentation 

In addition to this guide, see the HP StorageWorks Secure Path 3. OF Service Pack 2 for HP-UX Hi vl.O 
and Hi v2.0 release notes. 

Document conventions and symbols 



NOTE: 

Support for the HSG family of arrays ended with Secure Path for HP-UX 3.0F. Any references to support 
for those arrays applies to 3.0F and earlier releases. 



Table 1 Document conventions 



Convention 


Element 


Medium blue text: Related 
documentation 


Cross-reference links and e-mail addresses 


Medium blue, underlined text 
(http://www.hp.com) 


Web site addresses 


Bold font 


• Key names 

• Text typed into a GUI element, such as into a box 

• GUI elements that are clicked or selected, such as menu and list 
items, buttons, and check boxes 


Italic font 


Text emphasis 


Monospace font 


• File and directory names 

• System output 

• Code 

• Text typed at the command line 


Monospace , italic font 


• Code variables 

• Command-line variables 


Monospace, bold font 


Emphasis of file and directory names, system output, code, and text 
typed at the command line 



A CAUTION: 

Indicates that failure to follow directions could result in damage to equipment or data. 



& IMPORTANT: 

Provides clarifying information or specific instructions. 



m NOTE: 

Provides additional information. 
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HP technical support 

Telephone numbers for worldwide technical support are listed on the HP support web site 
http://www.hp.com/support/ . 

Collect the following information before calling: 

• Technical support registration number (if applicable) 

• Product serial numbers 

• Product model names and numbers 

• Applicable error messages 

• Operating system type and revision level 

• Detailed, specific questions 

For continuous quality improvement, calls may be recorded or monitored. 

HP recommends that customers sign up online using the Subscriber's choice web 
site http://www.hp.com/ qo/ e-updates . 

• Subscribing to this service provides you with e-mail updates on the latest product enhancements, 
newer versions of drivers, and firmware documentation updates, as well as instant access to 
numerous other product resources. 

• After signing up, you can quickly locate your products by selecting Business support and then 
Storage under Product Category. 

HP-authorized reseller 

For the name of your nearest HP-authorized reseller: 

• In the United States, call 1-800-345-1518. 

• In Canada, call 1-800-263-5868. 

• Elsewhere, visit the HP web site http://www.hp.com . Then click Contact HP to find locations and 
telephone numbers. 

Helpful web sites 

For other product information, see the following HP web sites: 

• http://www.hp.com 

• http://www.hp.com/country/ us/enq/ prodserv/storaqe.html 

• http:/ / www.hp.com/ support/ 

• http://www.docs.hp.com 
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1 Secure Path for Active-Passive 
disk arrays 



HP StorageWorks Secure Path is a server-based software product that enhances HP StorageWorks RAID 
array storage systems by providing automatic path recovery from server-to-storage-system connection 
failures. Secure Path supports multiple input/output (I/O) paths between host and storage, which 
improves overall data availability. If any component in a path between host and storage fails, Secure 
Path redirects I/O requests to an alternate path. 

This chapter provides the following Secure Path information: 

• Overview 

• Features 

• Software components 

• Secure Path operation 

• Secure Path for Active-Passive disk arrays hardware setup 

• Installing Secure Path for Active-Passive disk arrays 

• Managing Secure Path for Active-Passive disk arrays 

• Removing and upgrading Secure Path for Active-Passive disk arrays 

• Troubleshooting Secure Path for Active-Passive disk arrays 

Overview 

Secure Path is a high-availability software product that manages and maintains continuous data access to 
the following HP StorageWorks storage systems: 

• EVA3000 (HSVlOO) 

• EVA5000 (HSVllO) 

• MA6000 

• MA8000 

• RA8000 

Secure Path eliminates the RAID controller, host bus adapter (HBA), and interconnect hardware (cables, 
switches, and connectivity devices) as single points of failure in the storage system. 

By using redundant hardware and advanced RAID technology. Secure Path enhances fault tolerance and 
storage system availability by providing automated failover capability. 

Redundant physical connections define separate paths in a Secure Path hardware configuration. Each 
path originates at a unique HBA port on a server and ends at a unique RAID controller port in the 
storage system. 

Figure 1 illustrates basic Secure Path hardware configurations. The physical connections define two 
separate paths. Each path originates at a unique storage area network (SAN) HBA on a server and 
ends at a port on a separate RAID controller on the storage system. 
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Figure 1 Basic Secure Path Fibre Channel configuration 

Secure Path disk arrays enables dual StorageWorks RAID controllers to operate in an Active-Passive 
mode, referred to as dual-redundant multiple-bus mode. Multiple-bus mode allows each controller to 
process I/O independently of the other controller under normal operation. A path consists of a unique 
connection from adapter to device. I/O is active on one path at a time, and access to storage units 
(LUNs) may be moved between paths using the Secure Path Management utility spmgr. 

Secure Path takes advantage of preferred path unit attribute. Available storage units are preferred to 
one or the other of the two controllers by setting a preferred path unit attribute. This attribute determines 
which controller is used for access at storage system boot time. During runtime, storage units may 
be moved between paths at any time through the use of the Secure Path Management utility. On 
Active-Passive RAID storage systems, storage units may also be accessed on each controller through 
either of two available ports. 

The Secure Path software detects the failure of I/O operations on a failed path and automatically reroute 
traffic to other available paths. Secure Path software gathers alternate paths through available SAN 
switches, controllers, controller ports, and HBAs. Path failover is completed seamlessly, without process 
disruption or data loss. 

Following replacement of a failed adapter, cable, controller, or attached components, storage units can 
be restored or failed back to their original path using the Secure Path Management utility. 

To protect against drive failure in a Secure Path environment, you can configure your storage units 
using RAID levels 0, 1, or 5. 

Features 

Secure Path for Active-Passive disk arrays has the following features: 

• Provides StorageWorks dual-controller RAID systems and host servers equipped with multiple 
HBAs, redundant physical connectivity, and Fibre Channel SAN-switched fabric paths 

• Monitors each path and automatically reroutes I/O to an alternate path if an HBA, cable, switch, 
or controller fails 

• Determines the status of available storage units and physical paths through path verification 
diagnostics 

• Monitors and identifies failed paths and failedover storage units 
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• Facilitates static load balancing, which allows movement of devices between controllers 

• Automatically restores failed-over storage units to repaired paths with auto failback enabled 

• Implements anti-thrash filters to prevent failover or failback caused by marginal or intermittent 
conditions 

• Improves data throughput and increased bandwidth using dual RAID controllers configured in 
multiple-bus mode operation with load balancing enabled 

• Detects failures reliably without causing unnecessary failovers 

• Implements failover or failback actions transparently without disrupting applications 

• Facilitates remote management using the spmgr utility 

• Supports configuring an EVA LUN as a system boot, swap, or dump device on HP-UX 11 i vl.O 
and HP-UX Hi v2.0 

• Allows coexistence of Secure Path for Active-Passive disk arrays and Secure Path for Active-Active 
disk arrays on the same host 

• Allows connectivity of Active-Passive disk arrays and Active-Active disk arrays through the same 
HBA 

Software components 

This section describes the software components of Secure Path for Active-Passive disk arrays for HP-UX, 
including: 

• Drivers 

• Agent 

• Management tools 

• Controller ownership 

• Path definition 

Drivers 

The following Secure Path drivers manage paths to a storage device while providing a single device 
target to applications: 

• swsp driver — A failover driver that is presented as a pseudo-HBA driver to system SCSI disk 
drivers. This driver presents multiple paths of a LUN as a single device to the host SCSI disk driver. 
It also initiates path failover when necessary and manages all kernel threads related to failover. 

• hsx driver — An array-specific driver that provides paths from an HBA driver for specific 
arrays up to the swsp driver. This driver manages the separate paths to a LUN and encapsulates 
array-specific knowledge, such as specific commands to migrate a LUN from one controller to 
the other. 

Figure 2 illustrates the driver model structure. 
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Figure 2 Driver model structure 



Agent 

The Secure Path agent (spagent) is a daemon process that provides an interface for Secure Path 
applications and utilities to communicate to the Secure Path drivers. The spagent daemon also provides 
notification of path-change events through e-mail. You do not need to run the spagent daemon for 
Secure Path drivers to provide full failover functionality. Hov/ever, if you want an e-mail notification, then 
you must run the spagent daemon. The only supported method to start and stop the Secure Path 
agent is the spinit script. 

The spinit script starts and stops the Secure Path agent /sbin/spagent. 



Management tools 

The Secure Path Manager (spmgr) is a command line utility that allows you to monitor and manage 
Secure Path devices and change the configuration settings for drivers. See Managing Secure Path for 
Active-Passive disk arrays for a description of spmgr commands. 

The spinit script starts and stops the Secure Path agent /sbin/spagent. 

Controller ownership 

Storage systems that are multiple-bus capable generally contain a pair of redundant controllers and 
support one of the following basic operational models: 

• Active-Passive — In the Active-Passive model, all LUN's are assigned ownership to one controller 
of the pair for I/O processing. The other controller is inactive, but available as a substitute 

in case of a failure on the active controller. 

• Active-Active — In the Active-Active model, I/O processing may be routed through both controllers 
simultaneously, providing better performance in addition to high availability. 
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NOTE: 

Secure Path automatically retries I/O requests that terminate in error due to ownership transfers. 
Active-Passive disk arrays also queues new I/O requests until the ownership transfer has completed to 
ensure data integrity. 



Path definition 

Within Secure Path, a path is defined as the collection (configuration) of physical interconnect components 
including HBAs, switches, RAID controllers, and the ports on the controllers. Because the Secure Path 
driver component is positioned between the HBA driver and the system SCSI disk driver, the Secure Path 
driver distinguishes the physical paths when elements of the SCSI equivalent address are different. 

Some configurations include multiple switches within a fabric, with the switches connected by one or 
more interswitch links. Secure Path cannot detect these paths and cannot manage them. While these 
interswitch paths provide an additional level of redundancy within the fabric, their management is 
handled directly within the switch. Refer to the documentation received with your switch hardware for 
more information about interswitch link routing and failover policies. 

Secure Path automatically sets the path state and reflects the status of the current active path. Because 
of path failures, the currently active path may be different from what you expect. See Table 7 for a list 
and description of path states. 

Secure Path operation 

This section describes the following: 

• Fallback options 

• Load balancing 

• Path verification 

Path failover occurs automatically when a selected set of error conditions is detected. Secure Path 
normally performs path failover only when your I/O is active or you have enabled the path verification. 
However, it is possible for spmgr to show some units with a common failed path in the failover state, 
while other units remain accessible through that path. Units remain in the failed path if there is no 
I/O or until they are polled. 

Failover follows a hierarchy, conditioned by the state of load balancing, as described below. Secure 
Path does not change the mode of preferred paths in failover situations, so you can restore original 
path assignments after making repairs. 

• Load balancing disabled 

When a failure occurs. Secure Path marks the path failed and switches to the next available path 
connected to the same controller, if there is one. 

If there is no available path on the same controller. Secure Path attempts to move the device to a 
standby path on the other controller. 

• Load balancing enabled 

When a failure occurs. Secure Path marks the affected path as failed. This removes it from the list 
of usable paths for the LUN. If no active paths remain on the same controller, Secure Path attempts 
to move the device to a standby controller. 
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Failback options 

Secure Path lets you set the path fallback option to manual mode or automatic mode. 

• In manual mode, you must enter a management utility command to restore devices to their 
preferred path. The operation is performed even if system I/O is in process to the selected device. 

• In automatic mode, Secure Path tests a failed path at fixed intervals if I/O is in process for 
the affected device. If the path appears to be viable, the path state is set to active and I/O 
is routed through this path. 

Load balancing 

When enabled without selecting a policy, load balancing allows multiple paths between a host and a 
specific LUN to be used in a round-robin fashion. Using multiple paths spreads the load across all 
components in the RAID storage system and maximizes performance. 

Load balancing may not be used in environments that have device reservations as a lock mechanism 
because the RAID array controllers enforce reservations on a per-port basis. 

Load balancing requires a Fibre Channel configuration that results in at least four unique paths from 
the host node to the storage system. While this can be accomplished with several different physical 
configurations, maximum performance potential is achieved when all four ports of the RAID storage 
systems are used. 

When load balancing is enabled, the Secure Path driver by default, marks all the owning controller as 
active. This is true when the following conditions occur: 

• A host boots up. 

• Secure Path fails over a LUN from one controller to the other. 

• You manually move a selected LUN between controllers using the Secure Path Manager utility, 

spmgr. 

Secure Path supports four types of load balancing policies: 

• Round Robin — I/O is routed through the paths of the active controller in a round-robin fashion. 

• Least I/O — I/O is routed through the path that has the least amount of I/O requests. 

• Least Service Time — I/O is routed through the path that has the least completion time for an 
I/O request. 

• Least Bandwidth — I/O is routed through the path that has the least amount of bytes queued. 

Path verification 

When enabled with spmgr, path verification causes Secure Path to periodically test the availability of 
all paths to all LUNs for paths marked available, failed, active, or standby. Path verification does not 
test paths that are in a quiesced state. 

Path verification is useful for detecting failures that affect overall path redundancy before they affect 
failover capability. If an active path fails path verification, failover occurs. If an available path fails path 
verification, its state changes from available to failed. 

If a path marked failed passes path verification, the path state is set to available, and if auto-restore is 
enabled, the path becomes active. If the path is on the active controller, it is marked preferred. 
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management behavior 

Table 2 provides the summary of path management behavior for Secure Path. 



^ NOTE: 

Support for the HSG family of arrays ended with Secure Path for HP-UX 3.0F. Any references to support 
for those arrays applies to 3.0F and earlier releases. 



Table 2 Path management behavior summary of Secure Path 



Feature 


Behavior or action 


Startup 


Chooses the preferred path to the controller to which the LUN is online. 

Marks the preferred path active. If no path is marked preferred, selects one and 
makes it the active path. 


Active path failure 


Marks the active path as failed. 
Redirects I/O through available path. 

If there are no available paths, failover occurs to a standby path on the other 
controller. 


Available or standby path 
failure 


Performs path verification. 
Marks failed path as failed. 


Path repaired 


Marks the path available or standby, depending on which controller has the online 
device. 

If auto-failback is enabled and the path was the active path prior to the path failure, 
it makes the path the active path. 



You can use the spmgr utility to customize the management of your configuration. See Managing Secure 
Path for Active- Passive disk arrays for more information on spmgr customization. 



cure Path for Active-Passive disk arrays hardware setup 

This section provides the following Secure Path hardware setup information: 

• Hardware setup overview 

• Installing a new Secure Path configuration 

• Configuring switches 

• Configuring the HSG80-based StorogeWorks array 

• Configuring optional HSG80-based array features 

• Configuring the HSVlOO/llO-based StorogeWorks array 

• System configuration 

• Configuring SCSI-3 for HSGSO-bosed systems 

• What to do if ioscon does not see all paths to the array 

rdware setup overview 

The following procedure outlines the hardware setup: 

1. Prior to setting up your hardware, perform the following verifications: 

• All users hove logged off the server. 

• All array file systems hove been backed up and unmounted. 

• All volume groups hove been exported. 

2. Perform one of the following procedures: 
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• Configure SAN switches, as described in Configuring switches. 

• Configure the StorageWorks RAID array, as described in Configuring the HSG80-based 

StorogeWorks array. 

• Perform system configuration, as described in System configuration. 

If the array has not been configured with your HP server, complete the procedure described in Installing 
a new Secure Path configuration. 



Installing a new Secure Path configuration 

Perform the following steps before connecting the StorageWorks array to your host system: 

1. Verify that HP-UX 11 i vl.O or 11 i v2.0 is running. 

2. See the HP StorageWorks Secure Path 3.0F Service Pack 2 for HP-UX Hi vl.O and Hi v2.0 
release notes to verify that your configuration is supported. 

3. Use an FC utility to determine the world wide name (WWN) of the Fibre Channel (FC) adapters 
within the server. 

The appropriate FC utilities are fcmsutil and fcdutil. 

An example of the fcmsutil command follows. Use the output of this command to record the WWN 
of the HBAs that are connected to the array. This information is required to set up the host connection 
to the HSV-based array and for verification of your configuration. 

# fcmsutil /dev/tdO 

The instance number for the HBA is tdO. The system displays the following: 

Vendor ID is = 0x00103c 

Device ID is = 0x001028 

TL Chip Revision No is = 2.3 

PCI Sub-system Vendor ID is = 0x00103c 

I Sub-system ID is = 0x000006 

Topology = PTTOPT_FABRIC 

Local N_Port_id is = 0x011500 

N_Port Node World Wide Name = 0x50060b000009ce61 
N_Port Port World Wide Name = 0x50060b000009ce60 
Driver state = ONLINE 
Hardware Path is = 0/2/0/0 
Number of Assisted IDs = 59812 
Number of Active Login Sessions = 2 

In this example, record the N_Port Port World Wide Name, 50060b000009ce60. Do this for 
each HBA that is connected in the Secure Path configuration. 

Complete the following steps to connect the array to your host system. 

1. Connect FC cables between the FC HBAs and the ports on the HP SAN switch. 

2. Connect FC cables from each Active-Passive array controller port to the HP SAN switch. 

3. Complete the procedure described in Configuring switches. 

NOTE: 

HP recommends this configuration to optimize storage component availability. 
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Configuring switches 

To configure switches, complete the following steps: 

1. Turn on the power to the SAN switches. 

2. Log on to the switch. 

& NOTE: 

For more information, see the Fibre Channel SAN switch management guide that was shipped 
with your switch. 

3. At the switch: admin prompt, verify that the switch is in Fabric mode and not in QuickLoop 
mode by entering the following command: 

switch : admin> qlShow 

• If the switch responds Switch is not in QuickLoop mode, go to step 4. 

• If the switch is in QuickLoop mode, disable QuickLoop mode by entering the following 
command: 

switch : admin> qlDisable 

The switch responds by displaying the following information: 

Setting switch to Fabric mode. 
Committing configuration ... done . 
Re-enable FL ports 

4. Power up the StorageWorks array and complete the procedure described in Configuring the 
HSG80-based StorageWorks array or in Configuring the HSVlOO/llO-based StorageWorks 
array. 

Configuring thie HSG80-based StorageWorks array 

To configure the HSGSO-based array, complete the following steps: 

1. Establish a terminal connection to the top controller's command line interface (CLI) port. See 
the HSG80 ACS Solution Software for HP-UX installation and configuration guide for help 
in making that connection. 

2. Enter the following CLI commands to see your existing array configuration: 

HSG80> show this_controller 
HSG80> show other controller 

3. Determine whether your array is configured for loop or fabric connectivity. The following is a 
sample fabric connectivity setting: 

P0RT_1_T0P0L0GY = FABRIC 

If the port is configured for fabric mode, proceed to step 5. 

4. Configure the EMA12000, EMA16000, MA8000, or RA8000 array for fabric connectivity. 
Enter the following commands to set the array for SAN-switched fabric: 



HSGf 


iO> 


set 


this 


controller port 1 


topology= 


offline 


HSGE 


J0> 


set 


this 


controller port 1 


topology= 


fabric 


HSG80> 


set 


other 


controller port 


1 topology 


=of f line 


HSG5 


J0> 


set 


other 


controller port 


1 topology 


=f abric 


HSGf 


iO> 


set 


this 


controller port 2 


topology= 


offline 


HSGf 


iO> 


set 


this 


controller port 2 


topology= 


fabric 
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HSG80> set other controller port 2 topology=of f line 
HSG80> set other_controller port_2_topology=f abric 

5. Determine whether your array is configured for transparent failover mode or multiple-bus failover 
mode. The following is sample output of an array configured for transparent failover: 

Configured for dual-redundancy with ZG80200290 

In dual-redundant configuration 

If the controllers are configured in MULTIPLE BUS FAILOVER mode, go to step 7. 

6. Configure the EMA12000, EMA16000, MA8000, or RA8000 array for multiple-bus failover 
mode by accessing the CLI. For more information about the CLI and configuring the array, see 
the HSG80 ACS Solution Software for HP-UX installation and configuration guide and the 
HSG80 Array Controller CLI reference guide. These documents came with your HSG80 ACS 
Solution Software for HP-UX Solution Software Platform Kit. Enter the following commands 

as shown in order: 

HSG80> set nofailover 



& IMPORTANT: 

The other controller shuts down and you must manually restart it by momentarily pressing reset on 
the controller's front panel. Wait for two minutes for the controller to boot before proceeding. Ignore 

the controller misconf igured messages. 

HSG80> set multibus_f ailover copy=this_controller 



W NOTE: 

Wait two minutes for the controllers to reboot before proceeding. The controllers are restarted 
in multiple-bus mode. 

7. Verify that the array is in SCSI-2 mode by entering the following commands: 

HSG80> show this_controller 

HSG80> show other controller 

The following is a sample output of an array in SCSI-2 mode: 

SCSI_VERSION = SCSI-2 

^ NOTE: 

If you are planning to use SCSI-3 mode, see Configuring SCSI-3 for HSGSO-based systems. The 
array should be in SCSI-2 mode at this point. 

8. If the array is in SCSI-2 mode and you want to use the SCSI-3 mode, verify that unit DO is 
unassigned. If it is assigned, delete DO and reassign. To do this, enter the following command: 

HSG80> delete DO 

Go to step 12. 

9. If the array is not in SCSI-2 mode, set the array to SCSI-2 mode by entering the following 
command: 

HSG80> set this controller scsi version=scsi-2 

10. Restart the controllers to have SCSI-2 take effect by entering the following command: 

HSG80> restart other_controller 
HSG80> restart this_controller 

Wait for two minutes for the controllers to reboot before proceeding. 

11. Verify that the controllers are now in SCSI-2 mode by entering the following command: 

HSG80> show this controller 
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12. Perform the following steps if this is a new factory-configured array or one that is being 
reconfigured. The array's internal connection table may contain connections that are out of date. 

a. Review the array's internal connection table by entering the following command: 

HSG80> show connections 

b. Delete all connections to this host that are shown in the array's internal connection table. 
The first time the server scans the Fibre Channel bus during boot, the new connections 
are registered. 

e. Delete each connection by entering the following command: 

HSG80> delete connection name 

Connection name is one of the names listed in the array's internal connection table, 
which is displayed when you ran the show connections command in step a. 

13. Complete the array setup by creating LUNs and assigning LUN unit numbers. To do this, note 
the following information: 

• Refer to the HSG80 ACS Solufion Software for HP-UX installation and configuration guide 
that came with your StorageWorks Solution Software Kit for details. 

• If you are reconfiguring an array set up for SCSI-2 that already has LUNs configured, you 
may use these units without reconfiguring as long as you are using units DO through D7. 
However, if you are using offset LUNs D8 through D19 9, you must reconfigure these units. 

• In a SCSI-3 array, you can use units Dl through D127. Units D128 through D199 must 
be reconfigured. 

14. Follow the procedures described in Configuring optional HSG80-based array features, as 
needed. When you have completed any optional array feature, follow the procedure described 
in System configuration, to configure the system for Secure Path. 

Configuring optional HSG80-based array features 

This section provides the following optional HSG80-based array feature setup information and 
procedures, including: 

• Setting up additional SCSI-2 LUNs 

• Setting a preferred unit to a controller 

• Using SCSI-3 

• Managing the command console LUN in SCSI-2 mode 

Setting up additional SCSI-2 LUNs 

The HP-UX sdisk driver allows only 8 LUNs per target. The EMA12000, EMA16000, MA8000, or 
RA8000 arrays normally present the LUNs under a single target. You can set the array to present a 
second target of another 8 LUNs for a maximum of 16 LUNs for the array. 



See Table 3, when deciding which configuration to use. 

Table 3 Tarqet or LUNS per array comparison chart with dual fabric 



{Highest availability 


Lower availability 


Highest availability 


8 LUNs per array 
2 HBAs per server 


16 LUNs per array 
2 HBAs per server 


16 LUNs per array 
4 HBAs per server 


4 paths per LUN 


2 paths per LUN 


4 paths per LUN 


Load balancing 

(across 2 HBAs and 2 controller 
ports) 


No load balancing 


Load balancing 
(across 2 HBAs) 



With the architecture of the EMA12000, ESA12000, MA8000, or RA8000 array, load balancing can 
only be accomplished across ports of the selected controller in a redundant controller pair. 

1. Complete all configuration steps described in Hardware setup overview. 
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During the boot sequence, the ioscan creates a connection table entry in the array. 
Modifications to the array's connection table enable the second target of LUNs. 

2. Enter the following command for each A5158A, A6795A, or A6685A adapter: 

# fcmsutil /dev/td# 

3. Record the adapter's N Port Port World Wide Name (the last 4 hex digits should suffice) 
on a configuration schematic. 

4. Establish a CLI connection to the array and enter the following command: 

HSG80> show connections 

A connection table similar to the following is displayed: 

Connection Unit 

Name Operating system Controller Port Address Status Offset 
INEWC0N13 HP THIS 1 011000 OL this 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-DB13 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-DB12 
INEWC0N14 HP OTHER 1 021000 OL other 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-DB13 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-DB12 
INEWC0N15 HP OTHER 2 021000 OL other 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-DD71 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-DD7 0 
INEWC0N16 HP THIS 2 011000 OL this 0 

HOST_ID=500 6-0B00-0 0 0 9-DD71 ADAPTER_ID=50 0 6-0B0 0-00 0 9-DD7 0 

In this example, you can see that the adapter -DB12 is connected to port 1 of this controller 
with a connection name of INEWC0N13 and to port 1 of o//ier controller with a connection 
name of INEWC0N14. 

The connection names are assigned by the array. You can change the connection name as per 
your convenience or for setting up Selective Storage Presentation for using the array as part 
of a SAN. For more information, see the "Restricting Host Access" section in the HSG80 ACS 
Solution Software for HP-UX installation and configuration guide. 

5. Select two paths that you want to assign to the second target on the configuration map. 

This assignment must allow each adapter to reach opposite controllers (this and other) through 
opposite switches. 

For example, in the previous table, select either INEWC0N13 and 1NEWC0N15, or INEWC0N14 
and 1NEWC0N16 . . 

6. Enter the following commands for the selected pair: 

HSG80> set !newconl3 unit_of f set=l 0 
HSG80> set !newconl5 unit_of f set=l 0 

7. Initialize the LUNs that you want to define for the second target, using procedures described in 
the HSG80 ACS Solution Software for HP-UX installation and configuration guide. 

8. To view all LUNs, enter the following command: 

HSG80> show devices 

Up to 8 devices are displayed as used by units DO through D7, and the new devices is 
displayed as not used by assignment. 

9. Add the new devices as units DIO through (or up to) D17. For example: 

HSG80> add unit DIO M9 

HSG80> add unit Dll DISK40300 

Continue adding devices up to a maximum of D17. 

The array now identifies units from DIO to D17 with a unit offset of 10, as a second target 
of LUNs 0 to 7. 

10. Enter the following command at the server console: 
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# ioscan -fn (to see the new units) 

# insf -e (to install special files for each new unit) 

An ioscan -fnk now shows all new LUNs. You can see these new LUNs only on half of the 
original paths, and the old LUNs is seen on the other half of the original paths. 

11. If you do not see all or part of the new LUNs following the ioscan, complete the procedure 
described in What to do if ioscan does not see all paths to the array. 



NOTE: 

This irregularity results from HP-UX tables that are used by the OS to maintain accurate I/O system 
persistence across reboots and is not a cause for concern. 



ing a preferred unit to a controller 

In multiple-bus failover mode, you can specify units to be normally selected by a specific controller of a 
controller pair. This process is called preferring and is useful in static load balancing. 

Units can be preferred to one controller or the other by the pref erred path switch of the ADD UNIT 
or SET UNIT command. You must use this option of preferring a unit to a controller if you intend 
to use the preferred path feature in Secure Path. 

For example, enter the following command to prefer unit D5 to this controller, and then later set a 
preferred path to that unit using the Secure Path spmgr utility prefer command: 

HSG80> set D5 preferred path=this controller 

ng SCSI-3 

This section describes the following requirements for SCSI-3: 

• Secure Path 3. OF SP2 requires the HSG80 controllers to be at ACS firmware 8.7 or later for 
SCSI-3 operation with extended LUN support. To enable extended LUN support, the HSG80 
operating system mode parameter must be set to HP VSA. 

• The Command Console LUN (CCL) is required for SCSI-3, and the CCL is the first array unit (DO). 
This reduces the number of available LUNs by one on the HP-UX system. 



NOTE: 

To generate useful ioscan output during installation, do not enable SCSI-3 until instructed in 
System configuration. 



See Configuring optional HSG80-based array features if you want to configure an optional feature, or 
continue with System configuration to configure the system for Secure Path. 

naging the command console LUN in SCSI-2 mode 

The StorageWorks array is factory-configured with a virtual LUN, located on Controller A, LUN 0. This 
device is called the Command Console LUN (CCL) and it enables the array to get recognized by some 
host systems as soon as it is attached to the Fibre Channel switch and configured into the operating 
system. The CCL also serves as a communications device for the StorageWorks Command Console 
(SWCC) Agent. The CCL identifies itself to the host by using a unique identification string. This string, 
HSG80CCL, is returned in response to the SCSI Inquiry command. 

The following describes the CLI commands that affect CCL: 

• The CCL is enabled upon delivery. Determine its address by entering the following CLI command: 

HSG80> show this_controller 

• Disable the CCL by entering the following CLI command: 

HSG80> set this controller nocommand console lun 
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• Enable the CCL by entering the following CLI command: 

HSG80> set this controller command console lun 

In dual-redundant controller configurations, these commands alter the setting of the CCL on both 
controllers. 

When the CCL is enabled, its ID is the lowest-numbered available LUN. When creating LUNs and logical 
units on the RAID array using the CLI, you must reserve the address of the CCL to DO, and you must not 
use this address (DO) for a data LUN. However, if the CCL's LUN is assigned to a LUN, the CCL floats to 
the next-lowest LUN that is available. 



m NOTE: 

On HP servers running Secure Path, the floating nature of the CCL could result in unreliable unit 
assignments when adding or deleting units. HP recommends that DO be left unassigned if the CCL is 
required or that the CCL is disabled if it is not going to be used. 



Configuring the HSVlOO/llO-based StorageWorks array 

Before beginning the configuration, collect and record the following host information: 

• Host LAN name. 

• Host IP address. 

• Fibre Channel adapter WWNs configured for Secure Path. 

Use a supported web browser to access the Command View EVA management appliance. 



m NOTE: 

See the online Command View EVA help system or the Storage Management Appliance Element 
Manager for Enterprise Only user guide for information on these procedures. All of these procedures 
need to be completed for your host to use the virtual disks. 



Before your host servers can use the virtual disks, ensure that you have completed the following: 

1. Initialize the storage system and create disk groups. When you first view the EVA from the 
Command View EVA software, the storage pool is presented as uninitialized storage. Follow 
documented procedures for initializing the storage system and creating disk groups. 

2. Add the host to the storage system. Before the host can use the storage system's virtual disks, the 
host WWN of one HBA must be known to the storage system. Adding the host creates a path 
from the storage system to one host adapter. 

3. Add ports to all host adapters. From the host properties page, use Add Port to add connections 
to the remaining HBA host adapters. 

4. Create and present virtual disks to the host. Follow the steps to create the virtual disk family, 
virtual disks, and present the disks to the host. 

Several options are available for selecting a path preference and mode for a virtual disk. To optimize 
load balancing, the load should be evenly distributed between controller A and controller B. The boot 
default selected controller may be chosen by setting the controller Preferred path or mode. HP 
recommends that you use either Path A - Failover only or Path B - Failover only. This mode allows Secure 
Path to control failback to the original controller following a controller failure and replacement. 

S^NOTE 

Path A - failover or failback and Path B - failover or failback are not supported on Secure Path for 
HP-UX. This feature is designed for operating systems that cannot run Secure Path. 
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System 



configuration 



To configure the system for Secure Path, follow the steps below: 



1. Power on the server and boot HP-UX. 

During the boot process, device special files are created for each logical unit configured on 
the Active-Passive controller and are assigned to each LUN or virtual disk configured on the 
Active-Passive controller. Because Secure Path is not yet installed, you should see an instance 
of a LUN for every path to the array. For example, if you have 2 adapters, 2 switches, and 2 
connections from each switch to the array, you have 4 distinct device instances (paths) to each 
LUN that is configured on the array. 

2. Before installing Secure Path, verify that you can see all your Active-Passive storage devices by 
entering the following command: 

# ioscan -fnk 

If you do not see all or part of the new LUNs following the ioscan command, perform the 
procedure described in What to do if ioscan does not see all paths to the array. This anomaly 
results from HP-UX tables that are used by the OS to maintain accurate I/O system persistence 
across reboots and is not a cause for concern. 

Table 4 shows a normal array with a single LUN. 



HP StorageWorks Secure Path 3.0F Service Pack 2 for HP-UX 11 i vl.O and 11 i v2.0 



27 



Table 4 Example of a normal array with a single LUN 



Class 


1 


H/W path 


Driver 


S/W state 


H/W type 


Description 


Ba 


1 


0/2 


Iba 


CLAIMED 


BUS_NEXUS 


Local PCI Bus 


Fc 


0 


0/2/0/0 


td 


CLAIMED 


INTERFACE 


HP Tachyon TL/TS 
Fibre 


Channel Mass Storage Adapter 














/dev/tdO 


fcp 


0 


0/2/0/0.1 


fcp 


CLAIMED 


INTERFACE 


FCP Domain 


ext_bus 


7 


U/ z/ u/ U . 1 . 1 0 . zDD .u 


fcpdev 


CLAIMED 


INTERFACE 


FCP Device 
Interface 


target 


7 


n/9/n/ 

Z/ u/ 

0.1.18.255.0.0 


tgt 


CLAIMED 


DEVICE 




disk 


239 


0/2/0/0.1.18.255.0. 
0.0 


sdisk 


CLAIMED 


DEVICE 


DEC HSG80 








/dev/dsk/c7t0d0 /dev/rdsk/c7t0d0 


ext_bus 


9 


U/ Z/ U/ U. 1 . 1 7. ZDD.U 


fcpdev 


CLAIMED 


INTERFACE 


FCP Device 
Interface 


target 


8 


0/2/0/ 
0.1.19.255.0.0 


tgt 


CLAIMED 


DEVICE 




disk 


241 


0/2/0/0.1.19.255.0. 
0.0 


sdisk 


CLAIMED 


DEVICE 


DEC HSG80 








/dev/dsk/c9t0d0 /dev/rdsk/c9t0d0 


ba 


2 


0/4 


Iba 


CLAIMED 


BUS_NEXUS 


Local PCI Bus 
Adapter (782) 


fc 


1 


0/4/0/0 


td 


CLAIMED 


INTERFACE 


HP Tachyon TL/TS 
Fibre 


Channel Mass Storage Adapter 














/dev/tdl 


fcp 


1 


0/4/0/0.1 


fcp 


CLAIMED 


INTERFACE 


FCP Domain 


ext_bus 


13 


0/4/0/0.1.18.255.0 


fcpdev 


CLAIMED 


INTERFACE 


FCP Device 
Interface 


target 


9 


0/4/0/ 
0.1.18.255.0.0 


tgt 


CLAIMED 


DEVICE 




disk 


346 


0/4/0/0.1.18.255.0. 
0.0 


sdisk 


CLAIMED 


DEVICE 


DEC HSG80 








/dev/dsk/cl3t0d0 /dev/rdsk/cl3t0d0 




ext_bus 


15 


0/4/0/0.1.19.255.0 


fcpdev 


CLAIMED 


INTERFACE 


FCP Device 
Interface 


target 


10 


0/4/0/ 
0.1.19.255.0.0 


tgt 


CLAIMED 


DEVICE 




disk 


348 


0/4/0/0.1.19.255.0. 
0.0 


sdisk 


CLAIMED 


DEVICE 


DEC HSG80 








/dev/dsk/cl5t0d0 /dev/rdsk/cl5t0d0 



3. Choose one of the following options: 
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• If you are using SCSI-3, proceed to Configuring SCSI-3 for HSG80-based systems to continue 
the installation. 

• If you are using SCSI-2, proceed to Installing Secure Path for Active-Passive disk arrays to 
continue the installation. 

Configuring SCSI-3 for HSGSO-based systems 

To configure your SCSI-3 for HSGSO-based systems, follov/ the steps belov/: 

1. Establish a terminal connection to the top controller's CLI port to set the Operating System 
mode for each Connection Name path as shown in the following example: 

HSG80> show connections 

Connection Unit 

Name Operating System Controller Port Address Status Offset 
INEWCONl WINNT OTHER 1 011500 OL other 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-CE61ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-CE60 
INEWC0N2 WINNT THIS 1 021500 OL this 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-CE61ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-CE60 
INEWC0N3 WINNT THIS 2 021500 OL this 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-D8C7ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-D8C6 
INEWC0N4 WINNT OTHER 2 011500 OL other 0 

HOST_ID=500 6-0B0 0-0 00 9-D8C7 ADAPTER_ID=500 6-0B00-000 9-D8C6 

2. Change the operating system mode for each path shown to HP for SCSI-2 or HP VSA for 
SCSI-3. To do so, enter the following set of commands: 

HSG80> set INEWCONl operating_system=HP (or HP_VSA) 

HSG80> set INEWC0N2 operating_system=HP (or HP_VSA) 

HSG80> set INEWC0N3 operating_system=HP (or HP_VSA) 

HSG80> set INEWC0N4 operating_system=HP (or HP_VSA) 

The array must be running firmware revision ACS 8.7 or later to use the SCSI-3 protocol and the 
HP_VSA mode. 

3. Verify that all connections are now in HP mode by entering the following command: 

HSG80> show connections 

4. Verify that the array is in SCSI-2 mode by entering the following command: 

HSG80> show this_controller 

^ NOTE: 

If you want the array in SCSI-2 mode, stop here. 

If you want the array in SCSI-3 mode, complete step 5 through step 6. 

5. Set the array to SCSI-3 mode by entering the following command: 

HSG80> set this_controller scsi_version=scsi-3 

6. Restart the controllers by entering the following commands, to have SCSI-3 take effect: 

HSG80> restart other controller 
HSG80> restart this controller 
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^ NOTE: 

Wait two minutes for the controllers to reboot before proceeding. 



7. Verify that the controllers are now in SCSI-3 mode by entering the following command: 

HSG80> show this_controller 

8. Proceed to Installing Secure Path for Active-Passive disk arrays to continue the installation. 

What to do if ioscan does not see all paths to the array 

if your server has been factory integrated, or if you are adding units with SCSI-2 CCL enabled, changing 
array unit offsets, or adding array unit offsets, ioscan may not see part or all of the added or changed 
paths. This problem is caused by HP-UX tables that are used by the OS for maintaining accurate I/O 
system persistence across reboots. Enter the following series of commands to update system tables for 
accurate subsequent ioscans: 

# fcmsutil /dev/ tdO get remote all (to obtain all Target N Port ids in the 
form 0x011200 for attached arrays) 

# fcmsutil /dev/ tdO replace_dsk: Target N_Port_id#l 

# fcmsutil /dev/ tdO replace dsk Target N Port id#2 

# fcmsutil /dev/ tdO replace dsk Target N Port id#n 

# fcmsutil /dev/ tdl get remote all (to obtain all Target N Port ids in the 
form 0x011200 for attached arrays) 

# fcmsutil /dev/ tdl replace dsk Target N Port id#l 

# fcmsutil /dev/ tdl replace dsk Target N Port id#2 

# fcmsutil /dev/ tdl replace dsk Target N Port id#n 

# fcmsutil /dev/ tdn get remote all (to obtain all Target N Port ids in the 
form 0x011200 for attached arrays) 



# ioscan -fn 

For example, if your server has HBAs tdO and tdl, then you need to issue the following command for 
both HBAs: 

# fcmsutil /dev/ td2 get remote all 

Target N_Port_id is = 0x010000 
Target state = DVS_READY 

Symbolic Name = HSV210 - E8K_A5R1_0CE0_WIN_AA - CR0B42 

Port Type = N_PORT 
SLER Capable (supports Retry) = NO 

Target Port World Wide Name = OxSOOOlf el00270ce8 

Target Node World Wide Name = OxSOOOlf el00270ceO 

Common Service parameters (all values shown in hex) : 

Version Hi: 9 Version Low: 9 

BB_Credit: 0 Ciro: 1 

Alt_BBcred: 1 Rxsz : 800 

Conseq: ff RO_Bitmap: 1 

Resolution: 0 EDTOV(ms) : 0 

Vendor version (in hex) 0 0 0 0 



Target N_Port_id is = 0x010100 



30 Secure Path for Active-Passive disk arrays 



Target state = DVS_READY 

Symbolic Name = HSV210 - E8K_A5R1_0CE0_WIN_AA - CR0B42 

Port Type = N_PORT 
SLER Capable (supports Retry) = NO 

Target Port World Wide Name = 0x50001fel00270ce9 
Target Node World Wide Name = 0x50001fel00270ce0 

Common Service parameters (all values shown in hex) : 

Version Hi: 9 Version Low: 9 

BB_Credit: 0 Ciro: 1 

Alt_BBcred: 1 Rxsz: 800 

Conseq: ff RO Bitmap: 1 

Resolution: 0 EDTOV(ms): 0 

Vendor version (in hex) 0 0 0 0 



From this sample output, use Target N Port ids 0x011000 and 0x011100 and run the following 
commands: 

# fcmsutil /dev/tdO replace_disk 0x011000 

# fcmsutil /dev/tdO replace_disk 0x011100 

NOTE: 

You must issue these commands for each HBA and for each Target N Port id on the server. 



Installing Secure Path for Active- Passive disk arrays 

The installation process installs Secure Path drivers, management utilities, and manual pages. This section 
provides the follov/ing procedures and information: 

• Installing Secure Path 

• Installing Secure Path on a SAN boot device 

Installing Secure Path 

The Secure Path for HP-UX CD-ROM kit contains scripts that requires administrator access to install the 
Secure Path depot (package). The following procedure describes how to install Secure Path software: 

1. Ensure that all users have logged off the server and that all I/O from the server has ceased. 

2. Back up the entire system according to normal procedures. 

3. Insert the Secure Path for HP-UX CD-ROM into the CD-ROM drive. 

4. Verify that the pf s mountd and pf sd daemons are running by entering the following 
command: 

# ps -ef 1 grep pfs 

If these daemons are not listed, start them by entering the following commands: 

# pfs_mountd & 

# pfsd & 

5. Mount the CD-ROM by entering a command similar to the following: 

# pfs mount /dev/dsk/cdrom device file /mnt directory 
Example: 

# pfs_mount /dev/dsk/c2tldO /cdrom 
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In the previous example, cdrom device f ile is c2tldO and the mnt directory is 
/ cdrom. 

6. Change to the Secure Path installation directory in the CD-ROM by entering the following 
command: 

# cd /cdrom 

7. Install the Secure Path software on the server using the provided shell script by entering the 
following command: 

# . /install . sh 
NOTE: 

You must always use the install . sh script to install Secure Path. Do not use the swinstall 
command to install the Secure Path depot package. 

8. Select Secure Path 3.0F SP2 for HP-UX for Active-Passive disk arrays when prompted, and follow 
the on-screen instructions. 

The system reboots after successful installation of Secure Path 3. OF SP2 for HP-UX for Active-Passive 
disk arrays. 

i'NOTE 

In HP-UX 11 i v2.0, the following message is displayed at the end of the installation process: 

WARNING: The currently running configuration has changes that are being 
held for next boot. ==> Do you wish to continue? y 

Enter Y. 



The script checks the server for required drivers and patches before installing Secure Path. When the 
installation is complete. Secure Path claims the devices configured on the Active-Passive disk arrays. 

The install script builds the kernel and reboots the server after installation. See Installing Secure Path on a 
SAN boot device for detailed information about installation on an EVA boot disk. 



m NOTE: 

At least 100 MB of free disk space is required in the /tmp file system. 
After a successful installation and subsequent reboot, the following occurs: 

• An ioscan discloses new disk instances for each Active-Passive LUN configured on the server. 

• Secure Path claims all units that have been presented to the host from the array and numbers them 
sequentially, starting with target 0, LUN 0. 

• Secure Path is enabled with the following default values: 

• Auto-Restore-of f 

• Load Balancing-of f 

• Path Verification-on 

• Verification Period-30 seconds 

• Paths preferred-none 

• Console event logging of critical messages 

• Syslog event logging of critical and warning messages 

• Mail event logging of critical, warning, and informational messages enabled to send to 
the root account 

Use spmgr to customize your configuration. See spmgr commands for more information on 
the spmgr utility. 

Secure Path installs the following utilities: 
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• The Secure Path agent (/sbin/spagent) provides an interface for Secure Path applications to 
communicate with the Secure Path drivers. The spagent script starts after Secure Path installation 
and at system boot (for subsequent reboots) and must run for spmgr to operate. The spinit 
script (/sbin/init . d/spinit) starts and stops the spagent. 

• The Secure Path management utility (/sbin/spmgr) displays device information, actively 
manages paths to each device, and sets driver options such as load balancing, path verification, 
and auto-restore. See spmgr commands for more information. 

• The manual pages for spmgr, spagent, spinit, hsx, and swsp. 

If you are using StorageWorks Command Console (SWCC) to manage an HSG80 environment, all 
devices that existed prior to the install are now hidden behind the hsx and swsp drivers, and new 
names are presented to the sdisk SCSI class driver. 

To update the new device names, complete the following procedure: 

1. Execute the ioscan command to determine the new device names. 

2. Refer to the HSG80 ACS Solution Software for HP-UX installation and configuration guide and 
perform the following procedures: 

a. Modify the access device with the new name. 

b. Enable the option to start the agent during system boot. 

c. Restart the agent. 

Installing Secure Path on a SAN boot device 

Secure Path 3.0F SP2 supports SAN boot from an EVA LUN on HP-UX 11 i vl.O and 11 i v2.0. This includes 
providing high availability to the SAN boot LUN. Support for the SAN boot is provided only if the root 
volume group is configured using Logical Volume Manager (LVM). 

Secure Path 3. OF SP2 also supports the Dump and Swap devices configured on an EVA LUN on HP-UX 
Hi vl.O and Hi v2.0. 

This section describes the following: 

• Prerequisites 

• Installation steps 

• Limitations 

Prerequisites 

You must perform the following tasks before installing Secure Path on a SAN boot device: 

• Ensure that there are at least two paths to the active controller of the EVA disk array. 

• Ensure that the connectivity to the standby controller for the EVA boot LUN is disabled. 

• Install Hardware Enablement Bundle March 2003 (or later) before installing Secure Path for Hi 
vl.O. 

Installation steps 

To install Secure Path on a SAN boot device, follow the steps below: 

1. Install HP-UX 11 i vl.O or 11 i v2.0 on an EVA LUN. 

2. See the HP StorageWorks Secure Path 3. OF Service Pack 2 for HP-UX Hi vl.O and Hi v2.0 
release notes (part number T3549-96605) to verify that all required patches are installed. 

The system reboots automatically after the patch installation. 

3. Install Secure Path 3.0F SP2. 

The system reboots after the installation completes. 
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4. Determine the hardware path of the standby path for the EVA boot LUN by using the spmgr 
display and ioscan commands. Set the alternate boot path with this hardware path by using 
the command setboot -a hardware_path. 



m NOTE: 

To install Secure Path, follow the instructions in Installing Secure Path or Removing and upgrading 
Secure Path for Active-Passive disk arrays. Do not use the swinstall command to install the Secure 
Path depot package. 



Limitations 

The following are limitations to Secure Path for HP-UX on a SAN boot device: 

• Root /Swap /Dump are not supported with HSG LUNs. 

• Root /Swap /Dump must be kept under LVM while installing HP-UX. 

• Root/Swap/Dump must not be under VxVm configuration while installing HP-UX. 

• Do not configure multiple Swap/Dump devices as a whole disk before installing Secure Path 
3.0F SP2. 

• After the system reboots on a SAN LUN, do not run any applications before installing Secure Path. 

• Removing Secure Path for HP-UX is not supported on a SAN boot device. 

Managing Secure Path for Active- Passive disk arrays 

This section describes the user interface for the Secure Path for Active-Passive 3. OF SP2 manager utility 
spmgr, including: 

• Secure Path for Active-Passive devices 

• Displaying configuration information 

• Setting storage system parameters 

• Path management 

• Preferred controller 

• add and delete commands 

• Secure Path for Active-Passive remote management 
i^NOTE 

Examples are based on the HSG80 controller, but all actions are identical for the HSV controllers. 



Secure Path for Active-Passive devices 

The spmgr utility lets you monitor and manage devices, storage systems, and paths to units that are in the 
Secure Path for Active-Passive configuration. It also lets you modify the configuration to repair, replace, or 
reconfigure devices. The spmgr utility relies on spagent to handle calls to the driver (swsp). 

This section describes the following: 

• spmgr commands 

• Common spmgr terms 

spmgr commands 

Table 5 lists the spmgr command options. Their format and syntax are presented and described in the 
sections following the table. 
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Table 5 spmgr commands 



Command 


Options or arguments 


Description 




\AAA/I I IKlin inr^r^i iilKl 

vvvvLUiyiu forget lu/n 
-r WWNN all 


Adds a new device to the Secure Path for 
Active-Passive configuration 


spmgr alias 


alias_name old_name 
no argument 


Assigns an alias to an object 


spmgr clean 


■d [WWLUNID] 
-r [WWNN] 
all 


Cleans device data from the Secure Path's 
stale device list 


spmgr delete 


WWLUNID 
device 

-r WWNN all 


Removes a device from the Secure Path for 
Active-Passive configuration 


spmgr display 


-a[v] adapter 

-c[v] controller_ser_num 

-d[v] device 

-r[v] WWNN 

-p path-Instance 

■s 

■u 

no argument 


Displays information about configured Secure 
Path for Active-Passive devices 


spmgr log 


-c 0, I. .3 
■10, I. .3 
-n 0, 3 
no argument 


Sets logging to the console, system log file, 
and e-mail notification 


spmgr notify 


add severityjevel 
e-mail_address 
delete e-mail_address 

no nrniiimf^nt 


Manages e-mail address and event logging 
severity to each e-mail recipient 


spmgr passwd 


no argument 


Provides security on the server side to restrict 
client access 


spmgr prefer 


path_instance 


Assigns a preferred attribute to a path 


spmgr quiesce 


-a adapter 

-c controller_ser_num 

-p path_instance 


Moves I/O to an alternative object and 
temporarily removes the selected object from 
use 


spmgr refreshdis- 
play 


no argument 


Refreshes the array controller serial numbers 
NOTE: 

wriiy Trie coriiroiici c>t:;iiui riuiiiuci is 
updated and not the controller status. 
This is because the controller status is 
determined by the status of the paths going 
through that controller. 


spmgr restart 


■a adapter 

■c controller_ser_num 

-p pathjnstance 

all 


Returns a previously quiesced object to an 
active, available, or standby state 
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Command 


Options or arguments 


Description 


spingr restore 


-d device 
-r WWNN 
all 


n I 1 • ■ 1 1 • r 1 

Kestores one or more devices to their preterred 
I/O path 


spmgr select 


< controller_ser_num [-d device] 
-p pathjnstance 


Selects a path or controller for I/O. Also, 
initiates a LUN movement if necessary 


spmgr set 


-a on j off WWNN 

-b on j off 1 rr j lb 1 li / Is / 
WWNN 

-f interval 

-p on j off WWNN 


Enables or disables Secure Path features like 
load balancing, path verification 


spmgr unalias 


alias_name old_name 


Removes an alias 


spmgr unprefer 


path_instance 


Removes a preferred path attribute 



m NOTE: 

Commands entered without an argument respond with usage if the command is a configuration altering 
command. The commands alias, display, log, and notify respond with current command 
or configuration information. 



The changes to the configuration settings performed by the following commands are persistent across 
system reboots and Secure Path upgrades: 

• spmgr add 

• spmgr clean 

• spmgr delete 

• spmgr log 

• spmgr prefer 

• spmgr set 

• spmgr unprefer 

The changes to the configuration settings performed by the following commands are persistent across 
system reboots but not persistent across Secure Path upgrades: 

• spmgr alias 

• spmgr unalias 

• spmgr notify 

Common spmgr terms 

Table 6 describes the common spmgr terms. For more Secure Path for Active-Passive terms, see the 
glossary provided at the end of this guide. 
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Table 6 Common spmgr terms 



Term 


Definition 


Device 


The standard representation for a device or device link on a server. For 

PYnmnp" nytyr\7. 

\^^\Jl 1 1 1 1^ • I /\ -L \Jl i-1 


Logical Unit 


A device that is managed by Secure Path for Active-Passive and identified 
hv it<; '^9-dinit \A/nrld \A/idp UN Idpntifipr fwWT ITNTnl 


Adapter 


The operating system ID of the HBA 


Storage System Array WWNN 


A storage system is identified by its 16-digit World Wide Node Name 
(WWNN) 


Controller serial number 


The controller is identified by a unique serial number. The serial number of 
the HSG80 is a 10-character alphanumeric string 



Displaying configuration information 

This section describes the following: 

• Controller states 

• Path states 

• Device states 

• Understanding LUN and path instance numbering 

• Displaying header infornnation 

• Displaying differences between HSG and HSV controllers 

• display commands 

• alias and unalias commands 

Controller states 

Table 7 describes the possible controller states for Secure Path 3. OF SP2 for Active-Passive disk arrays. 
Table 7 Controller states for Secure Path 3.0F SP2 Active-Passive disk arrays 



Controller state 


Description 


Critical 


A controller pair bound in multi-bus failover mode when only one of the 
controllers is available. The Critical state may mean a failed or offline 
condition because the server cannot communicate with the controller at 
this time. 


Operational 


The controller is available with a good status. 


Unknown 


The server cannot communicate with this controller. 



Path states 

Table 8 describes the path states reported by Secure Path for 3. OF SP2 for Active-Passive disk arrays. 
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Table 8 Path states for Secure Path 3. OF SP2 Active -Passive disk arrays 



Path state 


Description 


Active 


The path is currently used for the I/O stream. 


Available 


The path is available on the active controller for the I/O stream. 


Failed 


The path is currently unusable for the I/O stream. 


Quiesced 


The path is valid, but has been made unavailable for I/O. 


Standby 


The path is valid on the standby controller. 



Device states 

Table 9 describes the device states for Secure Path 3. OF SP2 for Active-Passive disk arrays. 
Table 9 Device states for Secure Path 3. OF SP2 Active-Passive disk arrays 



Device state 


Description 


Critical 


Only one path remains available to the storage unit. 


Degraded 


One or more paths to the storage unit are failed. 


Operational 


All paths are available to the storage unit. 


Unknown 


Unable to communicate with the unit. This may indicate no available path 
or a failed device. 


Failed 


Paths are available but an inquiry to the device returns a not-ready state 
even after retries. 



Understanding LUN and path instance numbering 

When Secure Path for Active-Passive is installed or v/hen an array is added to a configuration, Secure 
Path for Active-Passive numbers LUNs sequentially starting v/ith target 0 LUN 0. This sequential numbering 
may not match the numbering of units on the array. For example, unit D12 on an HSG80 may have 
a device instance number of cl2tOd6 as seen in the spmgr display output. The cl2 is the next 
available instance number when the array was added and the t0d6 is simply the next LUN added 
following cl2t0d5. 

It is possible in most cases, however, to map the device instance number back to the array unit number 
by using the path instance number. In most cases, the path instance target or LUN doublet is the octal 
equivalent of the array unit number as seen by Secure Path for Active-Passive arrays. 

For example, here is partial output of an spmgr display command: 

TGT/LUN Device WWLUN_ID H/W_Path #_Paths 

0/ 3 cl2t0d3 6000-1FE1-0016-6C30-0009-2030-2549-000A 4 

255/0.0.3 

Controller Path Instance HBA Preferred? Path Status 
ZG20302549 no ^ 
c4t0d4 tdl no Active 
cl0t0d4 td3 no Available 

Controller Path Instance HBA Preferred? Path Status 
ZG20400420 no ^ 
c6t0d4 tdl no Standby 
c8t0d4 td3 no Standby 

TGT/LUN Device WWLUN_ID H/W_Path #_Paths 

0/ 4 cl2t0d4 6000-1FE1-0016-6C30-0009-2030-2549-000E 4 

255/0.0.4 

Controller Path Instance HBA Preferred? Path Status 
ZG20302549 no ^ 
c4t6d3 tdl no Active 
cl0t6d3 td3 no Available 
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Controller Path Instance HBA Preferred? Path Status 
ZG20400420 no ^ 
c6t6d3 tdl no Standby 
c8t6d3 td3 no Standby 

Convert the path instance target and LUN octal value to decimal. The decimal value is the array unit 
or virtual disk number. 

In this example, to determine the array's unit number for device cl2tOd3, convert the path instance 
c4tOd4 target or LUN octal doublet 04 to a decimal number 04. The HSG80 array's D4 is mapped to 
Secure Path for Active-Passive device cl2tOd3. 

For the example's second device cl2tOd4, the path instance c4t6d3 yields an octal doublet 63 that 
converts to a decimal 51. The server, therefore, sees a unit number 5l(D51 for an HSG80) from the array. 

If you are configuring an HSG80-based array, this conversion must account for unit offsets if they are 
used. If the unit number on the array is D2 5 and the unit offset is 2 0, the server sees a unit number of 5 
(25 minus 20), and the path instance for that unit is in the form of c#tOd5. 

If you are using an HSVllO or HSGBO-based array, virtual disk numbers or unit numbers greater than 
128/127, respectively, do not follow the above convention. For a virtual disk or unit number greater than 
128, Secure Path for Active-Passive assigns a new c instance number, drops the most significant bit 
(subtracts 128), and assigns the path instance number. For example, if an HSVllO presents a virtual disk 
number 138 to the server. Secure Path for Active-Passive assigns a device number cytld2, where y is a 
new c number and tld2 is derived from 138 - 128 = 10 converted to an octal 12. 

aying header information 

Due to the possible complexity of the Secure Path for Active-Passive configuration and the possibility of 
shared storage or clustered software across multiple servers, the display information always has the 
following two standard lines of information at the start of the display: 

Line 1: Server: Server Name Report Created: Date and Time 
Line 2: Command: Command string 

aying differences between HSG and HSV controllers 

All general examples in this document use the HSG80 serialization format and actual HSG80 examples. 
The HSG80 and HSVllO Array Controllers present objects to Secure Path for Active-Passive arrays in 
identical ways. Therefore, there are no differences in the way you manage settings, paths, and devices 
using the spmgr utility. 

There are, however, two differences in serialization of array objects that allow you to quickly determine 
which type of array is being displayed. The following examples show the differences: 

HSG80 

Controller Serial Number ZG10506981 

Array World Wide Node Name (WWNN) 5000-1FE1-0010-5B00 
World Wide LUN ID (WWLUNID) 
6000-1FE1-0010-5B00-0009-1050-6981-1234 

HSVllO 

Controller Serial Number P4889B29LC01J 

Array World Wide Node Name (WWNN) 5000-1FE1-0015-0AE0 

World Wide LUN ID (WWLUNID) 

600 5-08B4-0 00 1-40BF-0 00 0-AO 00-1234-00 00 



NOTE: 

The location of the sequence 12 34 in the WWLUNID examples is unique for each LUN and is in a 
different position for the array types. 
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display commands 

This section describes the spmgr display commands and associated switch parameters. Each switch 
produces a different type of display. 



m NOTE: 

You can use the verbose flag with some, but not all, cases of the command. 



Syntax: 

• spmgr display -a[v] HBA 

-c[v] controller serial number 

-d[v] device 

-p path instance 

-r[v] WWNN 

-s 

-u 

(no argument) 

The section describes the following for each of these command switches: 

• Description 

• Syntax 

• All forms of the command 

• Sample commands 

• Sample command output 

This section describes the following: 

• # spmgr display 

• # spmgr display -a[v] HBA 

• # spmgr display -c[v] controller_serial_number 

• # spmgr display -d^ devicejnstance 

• # spmgr display -p pathjnstance 

• # spmgr display -r[v] WWNN 

• # spmgr display -s 

• # spmgr display -u 

• # spmgr refreshdisplay 

# spmgr display 

When you enter the spmgr display command, all information for the entire configuration is displayed. 
The amount of information displayed depends on the number of HBAs, storage systems, and paths to a 
unit on each storage system. 

The full display derives from the component portions described in this section. You can limit the amount of 
data displayed by combining the spmgr display command with one of the described switches. 

Example: 

• spmgr display 

Server: hp.mydomain.com Report Created: Thu, Sep 13 16:11:50 
2004 

Command: spmgr display 



Storage: 5000-1FE1-0010-5B00 
Load Balance : Off Auto-restore : Off 
Path Verify: On Verify Interval: 30 
HBAs: tdO tdl 

Controller: ZG10505167, Operational 
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ZG10506981, Operational 
Devices: cl6t0d0 cl6t0dl 

TGT/LUN Device WWLUN_ID H/W_Path #_Paths 

0/ 0 cietOdO 6000-1FE1-0010-5B00-0009-1050-6981-0013 4 

0/0/255.0.0.0 

Controller Path Instance HBA Preferred? Path_Status 

ZG10505167 no 

c4t0d0 tdO no Standby 

clOtOdO tdO no Standby 

Controller Path_Instance HBA Preferred? Path_Status 
ZG10506981 no ^ 
c5tOdO tdO no Active 
clltOdO tdl no Available 

TGT/LUN Device WWLUN_ID H/W_Path #_Paths 

0/ 1 cietOdl 6000-1FE1-0010-5B00-0009-1050-6981-0014 4 

0/0/255.0.0.1 

Controller Path_Instance HBA Preferred? Path_Status 
ZG10505167 no ^ 
c4t0dl tdO no Standby 
clOtOdl tdl no Standby 

Controller Path Instance HBA Preferred? Path Status 
ZG10506981 no ^ 
c5t0dl tdO no Active 
clltOdl tdl no Available 

# spmgr display -aM HBA 

The -a switch lists HBA (adapter) related information. If a parameter is supplied, it must be the adapter 
instance number. 

Syntax: 

# spmgr display -a 

-av 

-a HBA 
-av HBA 

When the -a switch is used without a parameter, the display contains a complete list of all HBAs in the 
Secure Path for Active-Passive configuration from the server where the command is entered. 

Example: 

# spmgr display -a 

Server: hp.mydomain.com Report Created: Thu, Sep 13 16:11:50 
2004 

Command: spmgr display -a 
Adapters in the Secure Path 
Configuration 



tdO, tdl 

When the -a switch is paired with the v switch, the display contains a list of all adapters in the Secure 
Path for Active-Passive configuration. In this case, the v acts like a wildcard for the device switch -a. 

Example: 

# spmgr display -av 

Server: hp.mydomain.com Report Created: Wed, Aug 15 14:51:23 
2004 

Command: spmgr display -av 

Adapter Hardware Path Driver Version 



tdO 0/2/0/0 N/A 
tdl 0/4/0/0 N/A 

When invoked with the -a switch, v switch, and HBA, the display shows all paths attached to the 
HBA, as shown in the following example: 
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# spmgr display -av tdO 

Server: hp .mydomain . com Report Created: Wed, Aug 15 14:56:25 
2004 

Command: spmgr display -av tdO 



Adapter: tdO 

Hardware Path: 0/2/0/0 

Storage: 5000-1FE1-0010-5B00 

0 cl9t0d0 ZG10505167 tdO 0/0/255.0.0.0 cl4t0d0 
WWNN: 5000-1FE1-0010-5B00 Path State: Standby 

1 cl9t0d0 ZG10506981 tdO 0/0/255.0.0.0 cl5t0d0 
WWNN: 5000-1FE1-0010-5B00 Path State: Active 

2 cl9t0dl ZG10505167tdO 0/0/255.0.0.1 cl4t0dl 
WWNN: 5000-1FE1-0010-5B00 Path State: Standby 

3 cl9t0dl ZG10506981 tdO 0/0/255.0.0.1 cl5t0dl 
WWNN: 5000-1FE1-0010-5B00 Path State: Active 



# spmgr display -c[v] controller_serial_number 

The -c switch displays controller-related information. If a parameter is supplied, it must be a controller 
serial number. The command has four possible forms: 

Syntax: 

# spmgr display -c 

-cv 

-c controller serial number 
-cv controller serial number 

Example: 

# spmgr display -c 

Server: hp.mydomain.com Report Created: Thu, Sep 13 16:30:23 

2004 

Command: spmgr display -c 
Current Controller List 



ZG10505167, ZG10506981 
Example: 

# spmgr display -cv 

Server: hp.mydomain.com Report Created:Thu, Sep 13 16:30:23 
2004 

Command: spmgr display -cv 

Controller: ZG10505167 Status: Operational 
Vendor : HP 

WWNN: 5000-1FE1-0010-5B00 
HBAs: tdO, tdl 

Controller: ZG10506981 Status: Operational 
Vendor: HP 

WWNN: 5000-1FE1-0010-5B00 
HBAs: tdO, tdl 



Example: 



# spmgr display -c ZG10505167 

Server : hp . mydomain . com Report Created: Thu, Sep 13 16:39:49 2004 
Command: spmgr display -c ZG10505167 
Controller: ZG10505167 Status: Operational 
Vendor : HP 

WWNN: 5000-1FE1-0010-5B00 
HBAs: tdO, tdl 

Example: 

# spmgr display -cv ZG10505167 

Server : hp . mydomain . com Report Created: Thu, Sep 13:16:41:17 2004 
Command: spmgr display -cv ZG10505167 
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Controller: ZG10505167 Status: Operational 
Vendor: HP 

WWNN: 5000-1FE1-0010-5B00 
HBAs: tdO, tdl 

Item Device Controller HBA Parent Instance 



0 cietOdO 
WWNN : 500 0 

1 cietOdO 
WWNN : 50 0 0 

2 cietOdl 
WWNN : 500 0 

3 cietOdl 
WWNN : 500 0 

4 cl6t0d2 
WWNN : 500 0 

5 Cl6t0d2 
WWNN : 50 0 0 



ZG10505167 

-lFEl-0010- 

ZG10505167 

-lFEl-0010- 

ZG10505167 

-lFEl-0010- 

ZG10505167 

-lFEl-0010- 

ZG10505167 

-lFEl-0010- 

ZG10505167 

-lFEl-0010- 



tdO 

5B00 

tdl 

5B00 

tdO 

5B00 

tdl 

5B00 

tdO 

5B00 

tdl 

5B00 



0/0/255.0.0. 

Path State: 
0/0/255.0.0. 

Path State: 
0/0/255.0.0. 

Path State: 
0/0/255.0.0. 

Path State: 
0/0/255.0.0. 

Path State: 
0/0/255.0.0. 

Path State: 



0 c4t0d0 
Standby 

0 clOtOdO 
Standby 

1 c4t0dl 
Standby 

1 clOtOdl 
Standby 

2 c4t0d2 
Standby 

2 clOtOd2 
Standby 



# spmgr display -d[v] device_instance 

The -d switch displays device-related information. If a parameter is supplied, it must be a device instance. 
Syntax: 

# spmgr display -d 

-dv 

-d device instance 
-dv device instance 

Example: 

# spmgr display -d 

Server : hp .mydomain . com Report Created: Thu, Sep 13 16:44:25 2004 
Command: spmgr display -d 
Devices by Storage System 



Devices: cl6t0d0 cl6t0dl 
Example: 

# spmgr display -dv 

Server : hp .mydomain . com Report Created: Thu, Sep 13 16:50:04 2004 
Command: spmgr display -dv 

Device: cl6t0d0 Status: Operational [4 paths (2/0/2)] 
Storage: 5000-1FE1-0010-5B00 

LUN ID: 6000-1FE1-0010-5B00-0009-1050-6981-0013 
Preferred Controller: None 
HBAs: tdO tdl 

Device: cl6t0dl Status: Operational [4 paths (2/0/2)] 
Storage: 5000-1FE1-0010-5B00 

LUN ID: 6000-1FE1-0010-5B00-0009-1050-6981-0014 
Preferred Controller: None 
HBAs: tdO tdl 
etc . 
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m NOTE: 

Secure Path for Active-Passive disk arrays displays path states using the following convention: 

[total number of paths (active/failed/offline)] 

"Offline" refers to the total count of standby paths and failed paths. 

Actual numerical equivalents replace the text. 

For example, the following attributes are displayed as [10 paths (8/0/2)]: 
Total paths = 10, Active = 8, Failed = 0, Offline = 2 

Example: 

# spmgr display -d cl6t0d2 

Server : hp . mydomain . com Report Created: Thu, Sep 13 16:51:43 2004 
Command: spmgr display -d cl6t0d2 

Device: cl6t0d2 Status: Operational [4 paths (2/0/2)] 
Storage: 5000-1FE1-0010-5B00 

LUN ID: 6000-1FE1-0010-5B00-0009-1050-6981-0015 
Preferred Controller: None 
HBAs: tdO tdl 

Example: 

# spmgr display -dv cl6t0d2 

Server : hp . mydomain . com Report Created: Thu, Sep 13 16:51:43 2004 
Command: spmgr display -d cl6t0d2 

Device: cl6t0d2 Status: Operational [4 paths (2/0/2)] 
Storage: 5000-1FE1-0010-5B00 

LUN ID: 6000-1FE1-0010-5B00-0009-1050-6981-0015 
Preferred Controller: ZG10506981 
HBAs : tdO tdl 

Item Device Controller HBA Parent Instance 

0 cl6t0d2 ZG10505167 tdO 0/0/255.0.0.2 c4t0d2 
WWNN: 5000-1FE1-0010-5B00 Path State: Standby 

1 cl6t0d2 ZG10506981 tdO 0/0/255.0.0.2 c5t0d2 
WWNN: 5000-1FE1-0010-5B00 Path State: Active [P] 

2 cl6t0d2 ZG10505167 tdl 0/0/255.0.0.2 clOtOd2 
WWNN: 5000-1FE1-0010-5B00 Path State: Standby 

3 cl6t0d2 ZG10506981 tdl 0/0/255.0.0.2 clltOd2 
WWNN: 5000-1FE1-0010-5B00 Path State: Available 

# spmgr display -p pathjnstance 

The -p switch displays storage path information. A parameter is required and it must be a path instance. 
Syntax: 

# spmgr display -p path instance 
Example: 

# spmgr display -p c6t0d0 

Server : hp . mydomain . com Report Created: Thu, Sep 13 12:16:14 2004 
Command: spmgr display -p c6t0d0 
Path: c6t0d0 Adapter: tdO 

Controller: ZG10506770 Status: Operational 
Device: cl7t0d0 Status: Operational 

# spmgr display -r[v] WWNN 

The -r switch displays storage system information. If a parameter is supplied, it must be a WWNN. 
The command has four possible forms: 
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Syntax: 



# spmgr display -r 
-rv 

-r WWNN 
-rv WWNN 

Example: 

spmgr display -r 

Server: hp.mydomain.com Report Created: Wed, Aug 15 15:19:38 

2004 

Command: spmgr display -r 
Storage Systems List 



Storage: 5000-1FE1-0010-5B00 
Storage: 5000-1FE1-0010-59F0 

Example: 

# spmgr display -rv 

Server: hp.mydomain.com Report Created: Wed, Aug 15 15:21:02 

2004 

Command: spmgr display -rv 
Storage Systems List 



Storage: 5000-1FE1-0010-5B00 
Load Balance: Off Auto-restore: Off 
Path Verify: On Verify Interval: 30 
HBAs: tdO tdl 

Controller: ZG10505167, Operational 
ZG10506981, Operational 

Devices: cl9t0d0 cl9t0dl cl9t0d2 cl9t0d3 
Storage: 5000-1FE1-0010-59F0 
Load Balance: Off Auto-restore: Off 
Path Verify: On Verify Interval: 30 

HBAs: tdO tdl 

Controller: ZG10504878, Operational 
ZG10505136, Operational 

Devices: c21t0d0 c21t0dl c21t0d2 c21t0d3 c21t0d4 

c21t0d5 

etc . 

Example: 

# spmgr display -r 5000-1FE1-0010-59F0 

Server: hp.mydomain.com Report Created: Wed, Aug 15 15:24:14 

2004 

Command: spmgr display -r 5000-1FE1-0010-59F0 

Storage Systems List 



Storage: 5000-1FE1-0010-59F0 
Load Balance: Off Auto-restore: Off 
Path Verify: On Verify Interval: 30 
HBAs: tdO tdl 

Controller: ZG10504878, Operational 
ZG10505136, Operational 

Devices: c21t0d0 c21t0dl c21t0d2 c21t0d3 c21t0d4 c21t0d5 
Example: 

# spmgr display -rv 5000-1FE1-0010-59F0 

Server : hp .mydomain . com Report Created: Wed, Aug 15 15:25:49 2004 
Command: spmgr display -rv 5000-1FE1-0010-59F0 

Storage Systems List 



Storage: 5000-1FE1-0010-59F0 

Load Balance: Off Auto-restore: Off 

Path Verify: On Verify Interval: 30 
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HBAs: tdO tdl 

Controller: ZG10504878, Operational 
ZG10505136, Operational 

Devices: c21tOdO c21tOdl c21tOd2 c21t0d3 c21t0d4 c21t0d5 
Path Information: [P] = Preferred 

Item Device Controller HBAHardware Path Instance 



0 c21tOdO ZG10504878 tdO 0/0/255.1.0.0 clltOdO 
WWNN: 5000-1FE1-0010-59F0 Path State: Standby 

1 c21tOdO ZG10505136 tdO 0/0/255.1.0.0 cl2tOdO 
WWNN: 5000-1FE1-0010-59F0 Path State: Active 

2 c21tOdO ZG10504878 tdl 0/0/255.1.0.0 clStOdO 
WWNN: 5000-1FE1-0010-59F0 Path State: Standby 

3 c21tOdl ZG10505136 tdl 0/0/255.1.0.1 cl8t0dl 
WWNN: 5000-1FE1-0010-59F0 Path State: Available 

4 c21tOdl ZG10504878 tdO 0/0/255.1.0.1 clltOdl 
WWNN: 5000-1FE1-0010-59F0 Path State: Standby 

5 c21t0dl ZG10505136 tdO 0/0/255.1.0.1 cl2tOdl 
WWNN: 5000-1FE1-0010-59F0 Path State: Active 

6 c21tOdl ZG10504878 tdl 0/0/255.1.0.1 cl3t0dl 
WWNN: 5000-1FE1-0010-59F0 Path State: Standby 

7 c21tOdl ZG10505136 tdl 0/0/255.1.0.1 cl8t0dl 
WWNN: 5000-1FE1-0010-59F0 Path State: Available 

8 c21tOd2 ZG10504878 tdO 0/0/255.1.0.2 clltOd2 
WWNN: 5000-1FE1-0010-59F0 Path State: Standby 



# spmgr display -s 

This command requires no parameter and returns a display of all undiscovered units for each storage 
system. This switch provides the list of units by storage system and reports the WWLUNID for each. You 
can use the information gathered from this display to clean stale data from Secure Path for Active-Passive 
configuration. 

Example: 

#spmgr display -s 

Server : hp . mydomain . com Report Created: Wed, Aug 15 15:42:37 2004 
Command: spmgr display -s 
Undiscovered Units Listing 



Storage: (fire) 5000-1FE1-0000-1290 

LUN ID: 6000-1FE1-0000-1290-5000-1FE1-0000-4321 

6000-1 FE1-0000-1290-5000-1FE1-0000-4334 



Storage: (jazzy) 5000-1FE1-0003-4420 

LUN ID: 6000-1FE1-0000-9320-5000-1FE1-9321-5733 



# spmgr display -u 

This command requires no parameter and displays all unattached units for each storage system. The -u 
switch provides the list of units by storage system and reports the WWLUNID for each. You can use the 
information gathered from this display to add a unit to the Secure Path for Active-Passive configuration. 

Example: 

#spmgr display -u 

Server : hp . mydomain . com Report Created: Wed, Aug 15 15:42:37 
2004 

Command: spmgr display -u 
Unattached Units Listing 



Storage: (fire) 5000-1FE1-0000-1290 

LUN ID: 6000-1FE1-0000-1290-5000-1FE1-0000-4321 

6000-1 FE1-0000-1290-5000-1FE1-0000-4334 

Storage: (jazzy) 5000-1FE1-0003-4420 

LUN ID: 6000-1FE1-0000-9320-5000-1FE1-9321-5733 
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# spmgr refreshdisplay 

This command updates the serial number of all available array controllers. 
Syntax: 

• spmgr refreshdisplay 

alias and unalias commands 

Secure Path for Active-Passive supports the use of aliases. Aliases replace longer strings with shorter 
strings. 

Example: 

The WWNN of a storage system is 5000-1FE1-0005-3480. You can assign the alias Bird to repi 
the longer, less easy-to-remember WWNN, 5000-1FE1-0005-3480. 

When an alias is displayed by a spmgr command, the alias name is shown in parentheses before 
the term it substitutes. 

Example: 

storage: (fire) 5000-1FE1-0001-3420 
The alias is fire. 

The aiias command lets you do the following: 

• Define an alias and store it for future use. 

• Remove an alias from the alias table. 

• Display the alias table. 

This section describes the following: 

• # spmgr alias alias_name old_name 

• # spmgr unalias 

• # spmgr alias 

# spmgr alias alias_name old_name 

To add an alias to the alias table, use the following command: 
Syntax: 

• spmgr alias alias name old name 

The following example creates the alias Birdtop for the controller serial number ZG66654211. 

• spmgr alias Birdtop ZG66654211 

# spmgr unalias 

To remove an alias from the alias table, use the spmgr unalias command and specify the alias 
name or the old name. 

Syntax: 

• spmgr unalias old_name 
alias name 

In the following example, the alias Birdtop, is removed from the alias table. 

• spmgr unalias Birdtop 
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# spmgr alias 

Use the spmgr alias command to display the alias table. 
Syntax: 

# spmgr alias 

Example: 

# spmgr alias 

Server: hp .mydomain . com Report Created: Wed, Aug 15 15:42:37 

2004 

Alias:old string 



bob: 50 00-1 fel-00 00-1231 
jim: 50 00-1 fel-00 00-1233 
fredt: ZG1112 982354 42 
fredb: ZG238817 633215 



m NOTE: 

• When you run the spmgr display command, the screen output uses the alias, if any, and the 
standard storage system WWNN or controller serial number. The alias is enclosed in parentheses 

(alias_name). 

• For a command set that requires a parameter, it is assumed that the parameter or its alias may be 
input. You cannot alias a command. 



Setting storage system parameters 

The Secure Path 3. OF SP2 for Active-Passive driver has options that allov/s you to enable or disable on 
a storage system or global basis. You can turn off or on these options dynamically. These changes 
occur within 45 seconds. 

This section describes the follov/ing: 

• set command 

• log command 

• notify command 

set command 

The spmgr set command allows you to enable storage system-specific settings for Secure Path for 
Active-Passive disk arrays, including: 

• Load balancing— Secure Path for Active-Passive implements various types of load balancing 
algorithms to effectively use all of the available paths to a unit for I/O. By default, the load 
balancing is disabled. 

• Path verification— The driver checks the state of all possible paths to all units at a selectable 
period or frequency. By default, the path verification is enabled with a period of 30 seconds. 

• Auto-restore— The auto-restore command enables the driver to automatically restore paths 
to their preferred path after a failure and subsequent reinstatement of that path. By default, 
auto-restore is disabled. 

Syntax: 

• spmgr set [option] 
Options: 

• -b <on I of f > [WWNN] — Enables or disables load balancing. 
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• -b <type> [WWNN] — Enables a load balancing algorithm. 
The following are the load balancing types: 

• rr - Round Robin 
. li - Least I/O 

• Is - Least Service Time 

• lb - Least Bandwidth 

• -p <on I of f > [WWNN] — Enables or disables path verification. 

• -a <on I of f > [WWNN] — Enables or disables auto-restore. 

• -f <value> — Sets the path verification period (in seconds ). 

NOTE: 

WWNN is the World Wide Node Name of the Array. 



The set command includes the following: 

• # spmgr set -a on | off WWNN 

• # spmgr set -b on | off | rr | lb | li | Is WWNN 

• # spmgr set -p on | off WWNN 

• # spmgr set -f (1 ...65535 seconds) 

# spmgr set -a on | off WWNN 

This command enables or disables the auto-restore feature of the driver. When auto-restore is enabled, it 
directs the driver to monitor the state of the paths. If the preferred path fails and then later returns to 
service, the driver automatically reroutes all I/O to the restored path. When auto-restore is disabled, 
there is no auto-restore by the Secure Path driver. The I/O continues along the current path until another 
event changes the active path. By default, the setting is disabled (off). 



W NOTE: 

If you enable auto-restore using spmgr set -a on command and select a new path using the spmgr 
select path command, the selected path stays selected and is not auto-restored. Auto-restore returns 
to the currently active path only if that path has failed and the failure has been repaired. 



NOTE: 

On a server reboot, it does not matter if auto-restore is on or off, or if paths have been preferred or not. 
The active path comes up on the last path probed and not necessarily on the preferred path. You must 
run the spmgr restore all command to restore all active paths to their preferred paths. 



# spmgr set -b on | off | rr | lb | li | Is WWNN 

This command enables or disables the load balancing option of the driver. This command also allows 
you to set the type of load balancing algorithm to be used for path selection. The default load balancing 
algorithm is round robin. When load balancing is enabled, it allows I/O to be sent to the unit 
along all available paths per the selected algorithm. When load balancing is disabled, the I/O is sent 
along the preferred path (if one is selected) or the I/O will use the first available path. By default, 
the setting is disabled (off). 

# spmgr set -p on | off WWNN 

This command enables or disables the path verification of the driver. When enabled, this command 
verifies the state of all possible paths to all units. On large configurations with active I/O to many units, 
this command may reduce performance. By default the setting is enabled (on). 
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# spmgr set -f (1 ...65535 seconds) 

This command sets the path verification interval. You can set the interval between 1 to 65535 seconds. 
The use of the -f switch does not change the current state of the path verification. It only changes 
the value for the interval. Therefore, if path verification is disabled, it remains disabled with the new 
interval. By default, the setting is set to 30 seconds. 

The path verification interval is the same for all LUNs. The setting is retained even if all LUNs are 
deleted. Any new LUN added to the Secure Path configuration assumes the path verification interval 
that is currently set. 

log command 

The spmgr log command lets you enable logging from the Secure Path for Active-Passive device to the 
syslog, console, and e-mail notification. 

Syntax: 

• spmgr log -1 (level 0, 1..3) 

-c (level 0, 1 . .3) 

-n (level 0, 3 ) 

The numerical level indicates the message severity. The levels of severity are: 

1. Critical 

2. Warning 

3. Informational 

When you select a numerical level, messages of that severity and higher are delivered to the appropriate 
output. For example: 

• If 3 is selected, then 3, 2, and 1 are logged. 

• If 2 is selected, then 2 and 1 are logged. 

• If 1 is selected, then 1 is logged. 

• If 0 is selected, then logging is disabled for that item. 

The log command includes the following: 

• # spmgr log -I 0, 1..3 

• # spmgr log -c 0,1. .3 

• # spmgr log -n 0, 3 

• # spmgr log 

# spmgr log -I 0, 1..3 

This command sets the level of logging to the syslog of the server. When you select level 1 ...3, 
messages of that severity and higher are written to the syslog file. The default setting is 2. 

# spmgr log -c 0,1.. 3 

This command sets the level of logging to the console. When you select level 1..3, messages of that 
severity and higher are displayed on the console. The default setting is 1. 

# spmgr log -n 0, 3 

This command enables or disables logging to the notify function. This option has two values, 0 and 3. 
The default setting is 3. Level 0 is provided for disabling all notification messages. 

# spmgr log 

The spmgr log command displays the current logging settings. 
Example: 
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# spmgr log 

Server: hp . mydomain . com Report Created: Wed, Aug 15 15:42:37 
2004 

CurrentLog Options 

Syslog, enabled, level 2 
Console, disabled, level 0 
Notify, enabled, level 3 



notify command 

The spmgr notify command lets you manage the distribution of the three classes of event reports 
(critical, warning, and informational) using an e-mail address list. 

Syntax: 

#spmgr notify add 
delete 

(no argument) 

This section describes the following: 

• Severity levels 

• # spmgr notify add 

• # spmgr notify delete 

• # spmgr notify 

Severity levels 

Messages from the Secure Path for Active-Passive devices are one of the following three severity levels: 

• Critical messages are severity level 1. 

• Warning messages are severity level 2. 

• Informational messages are severity level 3. 

The notify command sends event notices from the highest to the lowest level of the severity, marking 
as follows: 

• A user with severity level 3 receives level 3, 2, and 1 severity messages. 

• A user with severity level 2 receives level 2 and 1 severity messages. 

• A user with severity level 1 receives severity level 1 messages only. 

# spmgr notify add 

This command adds an e-mail address to the notification list. 
Syntax: 

• spmgr notify add severity_level e-mail_address 
Example: 

• spmgr notify add 3 john.doe@oscar.edu.it 

In the example, the Severity level is 3 and the email address is john.doe@oscar.edu.it. 
NOTE: 

A user is defined by a unique email_address. A user with more than one email_address may have 
multiple records, one for each unique address. 
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# spmgr notify delete 

This command deletes an e-mail address from the notification list. 
Syntax: 

# spmgr notify delete e-mail_address 
Example: 

# spmgr notify delete julie.smith@hollywood.edu 

In this example, the email_address julie.smith@hollywood.edu is deleted from the notification list. 

# spmgr notify 

This command displays the list of users to be notified. 
Example: 

# spmgr notify 

Server: hp.mydomain.com Report Created: Wed, Aug 15 15:42:37 
2004 

Command: spmgr notify 
Current Log Options 
Severity Mode e-mail address 



1 M elizabeth . bradshawSdor k . com 
3 M evil . knevilSj ump . net 

2 M harry.houdini@magic.org 



Path management 

Secure Path for Active-Passive 3. OF SP2 supports up to 32 paths to an HSG or HSV unit on a storage 
system. Given the very large number of paths that can be configured for a single system, the spmgr 
utility is available to manage and monitor those paths. 

The path management tasks include: 

• Selecting paths 

• Quiescing and restarting objects and paths 
select command 

A path is a combination of all the components from server to the unit on the storage system. When you 
describe the entire path you must identify the HBA and the controller port. 

Selecting paths means to identify a path to be used for I/O. Path information, including selected paths, 
can be viev/ed v/ith one or more options of the spmgr display command. 

If the paths are selected for the duration of the server's current processing time, they are referred to as 
selected paths and are not preserved during a reboot or pov/er cycle of the server. 

Syntax: 

spmgr select -c controller serial number -d device 
-p path_instance 

You can use the follov/ing options v/ith the select command: 

• # spmgr select -c controller_serial_number 

• # spmgr select -c controller_serial_number -d device 

• # spmgr select -p pathjnstance 
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# spmgr select -c controller_serial_number 

This command selects the path with the specified controller serial number and makes that path active. For 
example, if there are three HBAs with paths through one controller, the Secure Path for Active-Passive 
device marks one path for each device from one HBA, not necessarily the same HBA. The result is to 
have identified selected paths for multiple units with this command. 

Example: 

• spmgr select -c ZG10505167 

Result: The Secure Path for Active-Passive device marks each path through the controller ZG10505167, to 
each unit as the selected path for I/O. 

# spmgr select -c controller_serial_number -d device 

This command selects the path with the specified controller and device and makes that path active. This 
command selects one controller. Therefore, the driver is able to mark one path for each device on that 
controller as selected. This command indicates which controller to begin selecting and which unit to end 
marking. Thus if there are three HBAs with paths through that controller, the Secure Path for Active-Passive 
device will mark one path for the device from one HBA. The overall result is to have identified selected 
paths for a single unit with this command. 

Example: 

• spmgr select -c ZG10505167 -d c21tOd2 

Result: The Secure Path for Active-Passive device marks each path through the controller ZG10505167, 
to unit c21tOd2 as the selected path for I/O. 

# spmgr select -p pathjnstance 

This command selects the specified path and makes that path active. This parameter path instance, 
satisfies the path equation because it contains the necessary components of HBA, controller port, and 
device. Therefore, no other switches or parameters are required to identify the path. 

Example: 

• spmgr select -p clStOdl 

Result: The Secure Path for Active-Passive device marks path clStOdlas the selected path for I/O. 

Preferred controller 

This section describes the following: 

• prefer and unprefer commands 

• Impact of load balancing and active paths 

• restore command 

• quiesce command 

• restart command 

The term preferred path means that the paths are being referred to the preferred controller LUN attribute 
on the array. 

To set the preferred controller LUN attribute on the array, complete the following steps: 

1. For HSG80, use the ADD or SET command and the pref erred path attribute for preferring a 
unit to this or o//ier controller. For example, you can assign a unit as preferred to this controller 
by entering the following command: 

HSG80> SET D6 PREFERRED_PATH = THI S_CONTROLLER 

2. For HSVllO, log onto the HSV Element Manager and complete the following steps for preferring 
a virtual disk to controller A or controller B: 

a. Select the virtual disk you want to modify in the Navigation pane. 



HP StorageWorks Secure Path 3.0F Service Pack 2 for HP-UX 11 i vl.O and 11 i v2.0 



53 



b. Set the Preferred Path/Mode to Path A-Failover Only or Path B-Failover Only on the Virtual 
Disk Active Properties page. 

c. Click Save Changes at the top of the Content pane to direct the system to process the change. 
A status page is displayed indicating the status of the modification completed successfully. 

d. Click OK. 

An updated properties page is displayed. 

On an array, each LUN may be assigned to a particular controller and be available for selection at 
startup. This feature is enabled by using the HSG80 or HSVllO management utilities. 

Because Secure Path can have more than one path to each controller, you can further specify a preferred 
path. To differentiate between the controller unit attribute of pref erred path and the Secure Path 
preferred path, this document refers to the controller-based preferred-path attribute as the preferred 
controller. 

The preferred path assignment lets you control setting static load balancing because the path chosen 
determines which adapter and controller port are designated as the default path at system startup. One 
preferred path can be assigned to each controller for each LUN. 

For the preferred path feature to work, you must set either the preferred controller LUN attribute on the 
array or the preferred path attribute on Secure Path, or both the preferred controller and preferred path 
attributes. 

Following are the examples of preferred path priority: 

* Controller attribute priority 

The preferred controller attribute has priority over the preferred path attribute. For example, if you 
have preferred controller A to a LUN and have also set the preferred path to that LUN as a path 
to controller B, a restore or reboot results in a path on controller A being selected as active. 

* Controller attribute and path priority 

If you have preferred controller A to a LUN and have also set the preferred path to that LUN as 
a path to controller A, a restore or reboot results in the preferred path on controller A being 
selected as active. 

* Path priority 

If you have no controller preferred to a LUN and have a preferred path set for that LUN, then a 
restore or reboot results in the preferred path being selected as active. 

To set the preferred controller LUN attribute for the HSG80, use the HSG80 ADD or SET commands and 
the preferred-path attribute for preferring a unit to this or o//ier controller. For example, you can assign a 
unit as preferred to this controller by entering the following command: 

HSG80> SET D6 PREFERRED_PATH = THI S_CONTROLLER 

To set the preferred controller LUN attribute for the HSVllO, log on to the Command View EVA and 
complete the following steps for preferring a virtual disk to controller A or controller B: 

1. Select the virtual disk you want to modify in the navigation pane. 

2. Set the Preferred Path/Mode to Path A-Failover Only or Path B-Failover Only on the Virtual 
Disk Active Properties page. 

3. Click Save Changes at the top of the Content pane to direct the system to process the change. 
A status page is displayed indicating the status of the modification completed successfully. 

4. Click OK. 

An updated properties page is displayed. 

^ NOTE: 

Path A - Failover/failback and Path B - Failover/failback are not supported on Secure Path for HP-UX. 
This feature is designed for operating systems that cannot run Secure Path. 
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At any time you can select a different path to be used for I/O. The selected path is not preserved for a 
server power cycle or operating system restart. To preserve an active path through power cycles and 
restarts, identify it as a preferred path. Preferred path identifications are marked by the Secure Path driver 
in the running system and the identifications are stored in the configuration files for that driver. Therefore, 
the path may be maintained permanently until removed or another preferred path is selected. 

prefer and unprefer commands 

To support adding and removing preferred paths, spmgr provides two commands, spmgr prefer and 
spmgr unprefer. These two commands each require the path instance parameter. 



NOTE: 

The results of these commands are stored in configuration files, and the files persist across reboots. 
Because these commands make dynamic changes to the driver in kernel space, spmgr update must be 
executed for the new configuration to persist across reboots. 



This section describes the following: 

# # spmgr prefer pathjnstance 

# # spmgr unprefer path_instance 

# spmgr prefer path_instance 

This command instructs the Secure Path driver to mark a selected path as preferred. If load balance is 
disabled, this path becomes the active I/O path. Additionally, spmgr adds the specified pathjnstance to 
the Secure Path driver's configuration file and upon reboot of the server, the preferred paths get restored. 

Syntax: 

# spmgr prefer path instance 

For this command to execute properly, you need to supply the path_instance on the command line. The 
path_instance is provided in the spmgr display listings. 

Example: 

# spmgr prefer c21t0d5 

# spmgr unprefer path_instance 

This command instructs the Secure Path driver to unmark the path as a preferred path. Additionally, the 
configuration file for the Secure Path driver is modified by removing the preferred path markings. 

Syntax: 

# spmgr unprefer path instance 
Example: path verification 

# spmgr unprefer c21t0d5 

Impact of load balancing and active paths 

Preferred path and selected path are meaningless designations when you enable load balancing. Load 
balancing treats all paths equally and directs I/O to all available paths. In other words, load balancing 
is a higher priority than preferred or selected paths. 

When load balancing is enabled, as a default, the Secure Path for Active-Passive device attempts to use 
all the available paths to a LUN in a round-robin fashion. 

If load balancing is enabled and you set the path as preferred, the driver marks the path as preferred, but 
the path is not used as preferred until the load balancing is turned off. 

If load balancing is enabled and you select a path, the system performs the following actions: 
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• If the path is on the standby controller, I/O moves to the standby controller and the selected path 
is one of the active paths. 

• If the path is on the active controller, the path continues to be used as one of the set of active paths, 
restore command 

Once a path has failed or has been taken offline by one or more events, the spmgr restore command 
lets you restore one or more LUNs to their preferred I/O path. This command lets you manually restore all 
or part of a configuration when the auto-restore feature is disable. 

The restore command provides the follov/ing options: 

• # spmgr restore -d device 

• # spmgr restore -r WWNN 

• # spmgr restore all 

A path to a device consists of an adapter (HBA) and a port on a controller (WWNN). A unit on a 
storage system may be seen through several paths, for example, more than one HBA and controller. The 
default for spmgr restore transitions all LUNs to their preferred controller and their adapter if they 
are specified. By using one or more of the switches for this command, you have full control of restoring 
preferred paths to the Secure Path for Active-Passive configuration. 

Use of this command assumes the following important conditions: 

• Paths were preferred previously. If paths to some LUNs are not preferred, no action is performed 
on those units. 

• Load balancing is currently disabled. If load balancing is currently enabled, no action is 
performed on any path. 

The restore command returns successfully if no restore action is taken by the driver. For example, if 
the preferred path has failed and a restore is issued, the command is successfully. 

Syntax: 

spmgr restore [option] 
Options : 

-d <device> -- Restores all paths to the given device, 
-r [WWNN] -- Restores all paths to the given array, 
all -- Full system-wide restore. 



m NOTE: 

WWNN is the World Wide Node Name of the Array. 



# spmgr restore -d device 

This command restores a preferred path to the specified device. 
Syntax: 

# spmgr restore -d device 
Example: 

# spmgr restore -d c21tOd2 

# spmgr restore -r WWNN 

This command restores a preferred path to the specified storage system. 
Syntax: 
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# spmgr restore -r WWNN 

Example: 

# spmgr restore -r 5000-1FE1-0010-5B00 

# spmgr restore all 

This command restores all LUNs to their preferred paths and preferred controller. If there is no preferred 
controller, the current controller becomes the default controller. If there is no preferred path, the current 
path becomes the default path. 

Syntax: 

# spmgr restore all 

quiesce command 

Quiescing an object means to: 

# Move all active I/O from an object to an alternate path 

# Mark all paths to the object as quiesced to temporarily remove the object from use 
The quiesce command provides the following options: 

# # spmgr quiesce -a HBA 

# # spmgr quiesce -c controller_serial_number 

# # spmgr quiesce -p pathjnstance 

Only the adapters and controllers are supported for Secure Path 3. OF SP2 for Active-Passive disk 
arrays. Quiescing individual path is supported to allow other fabric infrastructures, such as switches, to 
remove and replace. 

Syntax: 

# spmgr quiesce [option] 

Options : 

-a <adapter> 

-c <controller ser num> 

-p <path instance> 

# spmgr quiesce -a HBA 

This command moves all active I/O using this HBA to paths available on other HBAs. The paths of the 
specified HBA are marked as quiesced and no further I/O is sent along those paths until the HBA returns 
to service with the corresponding restart command. 

You can verify these actions by entering the following command to view the current path state. 

# spmgr display -a HBA 

Use this feature to move I/O to another adapter as the first step to replacing an HBA. 
Example: 

# spmgr quiesce -a tdO 

# spmgr quiesce -c controller_serial_number 

When this command is invoked, spmgr moves all active I/O using this controller to paths on the other 
controller of the storage system. The paths of the specified controller are marked as quiesced and no 
further I/O is sent along that path until the controller returns to service with the restart command. 

You can verify these actions by entering the following command to view the current path state. 

# spmgr display -c controller serial number 

Use this feature to move I/O to another adapter as the first step to upgrade or replace a controller. 
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Example: 



# spmgr quiesce -c ZG11233409 

# spmgr quiesce -p pathjnstance 

When this command is invoked, spmgr moves all active I/O using this path to another path on the same 
controller, if possible, or to a path on the other controller. The specified path is marked as quiesced and 
no further I/O is sent along that path until the restart command returns the path to service. 

You can verify these actions by entering the spmgr display command to view the current path state. 

Example: 

# spmgr quiesce -p cl2t0d5 

restart command 

Object restarting changes a quiesced adapter or controller to an available or standby state. When 
restarted, the HBA or controller is available as an I/O entity for a path. 

Syntax: 

# spmgr restart [option] 

Options : 

-a <adapter> 

-c <controller ser num> 

-p <path instance> 

all — Full system-wide restart 

^ NOTE: 

The restart command returns successfully if no restart action is taken by the driver. For example, if a 
restart is issued to a path that is not quiesced, the command returns successfully. 

The restart command provides the following options: 

# # spmgr restart -a HBA 

# # spmgr restart -c controller 

# # spmgr restart -p path_instance 

# # spmgr restart all 

# spmgr restart -a HBA 

When this command is invoked, spmgr verifies the existence of the HBA and then uses the HBA to 
change the state of the paths to available or standby. If the auto-restore feature is enabled and a path 
using that HBA is the preferred path, the path is made as the active path. 

Example: 

# spmgr restart -a tdO 

# spmgr restart -c controller 

When this command is invoked, spmgr verifies the existence of the controller and then changes the state 
of the paths using the controller to standby. If the auto-restore feature is enabled and a path using that 
controller is the preferred path, then the path is made as the active path. 

Example: 

# spmgr restart -c fire-top 
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# spmgr restart -p path_instance 

When this command is invoked, spmgr verifies the existence of the path and then changes the state of 
the path to available or standby. If the auto-restore feature is enabled and the path is the preferred path, 
the path is made as the active path. 

Example: 

• spmgr restart -p cl2t0d5 

# spmgr restart all 

When this command is invoked, spmgr verifies the existence of all components on quiesced paths and 
changes those paths to available or standby as appropriate. If the auto-restore feature is enabled and 
one or more of those paths are preferred paths, those paths are made as the active path. 

add and delete commands 

Secure Path for Active-Passive disk arrays enables the dynamic addition and deletion of LUNs by using the 

spmgr add and spmgr delete commands. 

This section describes the follov/ing: 

• Adding LUNs 

• Deleting LUNs 

Table 10 describes terms that have special meaning for the spmgr command. 
Table 10 spmgr terms 



Term 


Description 


Add 


Refers to using spmgr to add a LUN or all LUNs of an array to the Secure 
Path for Active-Passive configuration 


Delete 


Refers to using spmgr to remove a LUN or all LUNs of an array from the 
Secure Path for Active-Passive configuration 


Present 


Refers to using the StorageWorks array utilities to add a unit or virtual disk 
so that the server or host can see it 


Unpresent 


Refers to using the StorageWorks array utilities to remove a unit or virtual 
disk so that the server or host cannot see it 



Adding LUNs 

The spmgr add command provides the follov/ing options: 

• # spmgr add WWLUNID 

• # spmgr add -r WWNN all 

During installation, all hISGSO units and HSVllO virtual disks that are presented to the server are added 
and attached by Secure Path for Active-Passive disk arrays. 

Complete the follov/ing steps to add storage after installation: 

1. Present the units or virtual disks to the storage system. 

2. Run ioscan to add and attach the new storage. 

3. Run insf to install and assign device files. 

NOTE: 

The spmgr add command is not required for adding new storage. 
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To add units or virtual disks that have been previously deleted using spmgr delete and are displayed 
in the spmgr display -u list of unattached devices, complete the following steps: 

1. Run spmgr add to add the LUNs to Secure Path for Active-Passive disk arrays. 

2. Run ioscan to claim the LUNs. 

3. Run insf to install and assign device files. 

& NOTE: 

To configure a LUN under Secure Path during nev/ LUN discovery or during the spmgr add, resources, 
c#t#d# value, and system memory must be available. If any of these resources are not available, the 
LUN v/ill be in an unmapped state and is displayed as part of the unattached list. To map these LUNs and 
to add them to the Secure Path active list, ensure that the resources are available and you run ioscan . 



# spmgr add WWLUNID 

This command verifies the specified unit and adds the unit to the storage system. 
Syntax: 

# spmgr add WWLUNID 

i^NOTE 

WWLUNID is the World Wide LUN ID of the unit to add to the storage system. 
Example: 

# spmgr add 6000-1FE1-0005-B480-0009-9341-4111-00FB 

When this command is invoked, the Secure Path for Active-Passive device searches for the unit and, 
if it is available, adds it to the data. 

This command requires that you use administrative commands before and afterwards. Before running 
thespmgr add command, the system must found the new array units and after running the spmgr 
add command, units must be claimed by the system. This command sequence must be done at least 
once for adding single or multiple units. 

Example: 

# spmgr display -u (to identify unmapped WWLUNIDs) 

# spmgr add WWLUNIDl [target LUN] 

# spmgr add WWLUNID2 [target LUN] 

# spmgr add WWLUNIDn [target LUN] 

# ioscan -fnCdisk (for the Server to claim newly added units) 

# insf -e (to install and assign device files) 

g'NOTE 

The driver settings can override the values you have supplied for the target and LUN. 



# spmgr add -r WWNN all 

This command identifies all unclaimed units for the specified array and adds them all to the Secure 
Path for Active-Passive configuration. 

Syntax: 

# spmgr add -r WWNN all 
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^ NOTE: 



WWNN is the World Wide Node Name of the array that adds all of its units to the Secure Path for 
Active-Passive configuration. 



Example: 

# spmgr add -r 5000-1FE1-0000-1234 all 

When this command is invoked, the Secure Path for Active-Passive device searches for all unclaimed 
units associated with the specified array and, if available, adds them to the data. At the same time, 
the configuration files gets updated. 

This command requires that you use administrative commands before and afterwards. Before running 
the spmgr add command, new array units must be found by the system and after running the spmgr 
add command, units must be claimed by the system. This command sequence must be done at least 
once for adding single or multiple units. 

Example: 

# spmgr display -u (to identify the WWNN of the array with unmapped units) 

# spmgr add -r WWNN all 

# ioscan -fnC disk (for the server to claim newly added units) 

# insf -e (to install and assign device files) 

Deleting LUNs 

The spmgr delete command provides the following options: 

# # spmgr delete WWLUNID | device 

# # spmgr delete -r WWNN all 

To unpresent a storage device or array from the Secure Path for Active-Passive configuration, complete the 
following procedure: 

1. Delete the device or array from Secure Path for Active-Passive arrays using the spmgr delete 
command. 

2. Remove or unpresent the device from the array. 
^ NOTE: 

If a device that has been deleted and unpresented is subsequently re-presented to the array, the device 
(or devices) is brought into Secure Path for Active-Passive arrays in the unattached (spmgr display 
-u) list. The Secure Path for Active-Passive device keeps track of the device deleted status as long as the 
server has not been rebooted. 



Complete the following steps to delete a LUN from the attached list of LUNs and have that device be seen 
as unattached using the spmgr display -u command: 

1. Run spmgr delete command to remove the LUN. 

2. Run ioscan to unattach the device. 

# spmgr delete WWLUNID | device 

This command verifies the device and, if correct, removes the device from the Secure Path for Active-Passive 
configuration. These actions occur only on the server where the command was issued. For shared 
storage, the unit must be deleted on each server that has access to it. 

Syntax: 

# spmgr delete WWLUNID | device 
Example: 
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# spmgr delete fireD12 

The alias f ireD12 is the WWLUNID. 

After the delete, use the following command sequence at least once to delete one or more units from 
the system. 

Example: 

# spmgr display (to identify WWLUNIDs) 

# spmgr delete WWLUNIDl 

# spmgr delete WWLUNID2 

# spmgr delete WWLUNIDn 



NOTE: 

If the units ore being unpresented or removed from the array, you do not need to execute the following 
command: # ioscan -fnC disk (for the server to unclaim deleted units) 



# spmgr delete -r WWNN all 

This command identifies all unclaimed units for the specified array and deletes them all from the Secure 
Path for Active-Passive configuration. This command can take up to 15 minutes to complete for the 
maximum number of units (256). 

Syntax: 

# spmgr delete -r WWNN all 

WWNN is the World Wide Node Name of the array that has all of its units deleted from the Secure 
Path for Active-Passive configuration. 

Example: 

# spmgr delete -r 5000-1FE1-000-1234 all 

This command verifies the array and, if correct, deletes all of the array's devices from the configuration. 

These actions occurs only on the server where the command is issued. For shared storage, the unit must 
be deleted on each server that has access to it. 

Example: 

# spmgr display (to identify the WWNN of the array to be deleted) 

# spmgr delete -r WWNN all 



NOTE: 

If the units are being unpresented or removed from the array, you do not need to execute the following 
command: # ioscan -fnC disk (for the server to unclaim newly deleted units) 



clean command 

The spmgr clean command provides the following options: 

• # spmgr clean -d WWLUNID 

• # spmgr clean -r WWNN 

• # spmgr clean all 

The clean command cleans the stale persistent information. 
Syntax: 

• spmgr clean [option] 
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Options : 

-d <WWLUNID>-Cleans LUN configuration data from the stale device list. 

-r <WWNN>-Cleans all the array configuration data from the stale device list. 

all -- Full system-wide clean. 

NOTE: 

WWNN is the World Wide Node Name of the array, and WWLUNID is the World Wide LUN ID of the 
device. 



# spmgr clean -d WWLUNID 

This command verifies and cleans the indicated unit from Secure Path for Active-Passive configuration. 
Syntax: 

# spmgr clean -d WWLUNID 

Example: 

# spmgr clean -d 6000-1FE1-0000-9320-5000-1FE1-9321-5733 

# spmgr clean -r WWNN 

This command identifies all undiscovered units for the specified array and cleans the persistent data of 
those units from the Secure Path for Active-Passive configuration. 

Syntax: 

# spmgr clean -r WWNN 

Example: 

# spmgr clean -r 5000-1FE1-0003-4420 

# spmgr clean all 

This command identifies all undiscovered units on the system and cleans the persistent data of those units 
from the Secure Path for Active-Passive configuration. 

Syntax: 

# spmgr clean all 

client command 

The client command allows you to connect or disconnect from the server. 
Syntax: 

# spmgr client [option] 
Oprtions : 

add <client name>— Allows the remote client to communicate with the server, 
delete <client name>— Disables the remote client that is 
communicating with the server. 

# spmgr passwd 

This command provides security on the server side to restrict client access. 
Syntax: 

spmgr passwd/password <newpas sword> 
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m NOTE: 

You cannot execute the spmgr passwd command remotely. 



Secure Path for Active-Passive remote management 

Remote management executes spmgr commands on any server in which Secure Path for Active-Passive 
disk arrays is installed. 

This section describes the follov/ing: 

• Installing remote management 

• Removing a client from the server 

• Remote spmgr execution 

Installing remote management 

To install remote management, complete the following steps: 

1. Copy spmgr from the /sbin directory (in which Secure Path for Active-Passive disk arrays 
resides) to the remote host. 

2. In the local system, add the remote client's name by entering the following command: 

spmgr client add client name 

The cllent name is the name of the client host that is managed by Secure Path for 
Active-Passive disk arrays. 

For example: 

# spmgr client add xyz.hp.com 

The client add command enables the remote client to communicate with the server in which 
Secure Path for Active-Passive disk arrays is installed and is to be managed. 

Removing a client from the server 

To remove access to a remote host for managing the local host, enter the following command in the 
local host: 

spmgr client delete client name 

The cllent name is the name of the client to be deleted from the host that manages Secure Path 
for Active-Passive disk arrays. 

For example: 

• spmgr client delete xyz.hp.com 

The client delete command prevents the remote client from communicating with the server on which 
Secure Path for Active-Passive disk arrays is installed and managed. 

The previous commands must be executed from the server on which Secure Path for Active-Passive array is 
installed and is to be managed. 

Remote spmgr execution 

To execute remote management, enter the following command: 

spmgr remote host: command name 

Example: 

• spmgr xyz . hp . com : display 
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The spmgr remote host : command name command executes the specified command on the 
system on which Secure Path for Active-Passive disk arrays is installed, and displays information on 
the remotely managed host. 

You can execute the following commands remotely: 

• add 

• clean 

• delete 

• display 

• log 

• prefer 

• quiesce 

• ref reshdisplay 

• restart 

• restore 

• select 

• set 

• unprefer 

You cannot execute the following commands remotely: 

• alias 

• client 

• notify 

• passwd 

• unalias 



Removing and upgrading Secure Path for Active- Passive disk 
arrays 

This section describes how to remove or upgrade Secure Path for Active-Passive disk arrays, including: 

• Removing Secure Path 

• Upgrading Secure Path software 

Removing Secure Path software 

You can remove Secure Path by using HP's SD utility or the System Administration Manager (SAM). 
When you remove Secure Path, all files, including configuration files, are removed. 

You can use SAM or enter the following command to remove Secure Path: 

• swremove -x autoreboot=true CPQswsp,r=* 

NOTE: 

After removing Secure Path, you must reconfigure the array for transparent failover mode and restore the 
server to a single-path RAID storage environment. In a single-path configuration, the HSG80 controllers 
is set to transparent failover mode. See the HSG80 ACS Solution Software for HP-UX installation and 
configuration guide for details. 

If Secure Path is installed on a SAN boot device (EVA LUN), refer to Secure Path Boot Device (EVA 
LUN) for further details. 

Upgrading Secure Path softv/are 

This section describes the requirements and procedures to upgrade Secure Path software, including: 
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• Upgrade requirements 

• Upgrade preparation 

• Upgrading from the Web 

Upgrade requirements 

The following requirements must be met to ensure a successful installation: 

• At least 100 MB of free disk space is required in the /tmp file system for installation. 

• The system must have an additional 10 MB of space in /usr and 10 MB in /opt . 

Upgrade preparation 

Secure Path 3. OF SP2 does not support HSG80 array controllers using ACS 8.6 in SCSI-3 mode. It still 
supports ACS 8.6 or later in SCSI-2 mode. Since 3. OF SP2 with ACS 8.7 or later enables the support of 
up to 127 LUNs per array, HP recommends that you configure the array for SCSI-3 operation. 

If you are upgrading an existing Secure Path 3.0 configuration, and you are adding Enterprise Virtual 
Array (EVA) systems to the configuration, perform the upgrade on the existing HSG80-based storage first. 
Then, add the HSVllO-based storage using the hardware setup described in Secure Path for Active-Passive 
disk arrays hardware setup after the Secure Path 3. OF SP2 upgrade is complete and verified. 

This procedure does not change your existing StorageWorks device file assignment or modify any existing 
logical volumes. It only adds and attaches all new or unattached LUNs that can be seen by your server. 
Depending on the existing target or LUN numbering, it can add these devices in nonsequential order. 

To add and attach the new or unattached LUNs, complete the following steps: 

1. Verify that your server and storage configuration meets the software, patch, firmware, and 
hardware revision levels defined in the Secure Path 3. OF Service Pack 2 for HP-UX Hi vl.O, 77/ 
v2.0 and Secure Pafh 3. OF Service Pack 2 Workgroup Edition for HP-UX Hi vl.O, 77/ v2.0 
release notes (part number T3549-96505). 

2. Ensure that all users have logged off the server and that all I/O from the server has ceased. 

3. Perform a complete system backup and document your server file systems, mount points, and 
device files. 

4. Select one of the following SCSI options: 

• If you want to continue to use SCSI-2 and ACS 8.6 or later, proceed to Upgrading from 
the Web. 

• If you are using SCSI-2 and want to use SCSI-3, you must first change the array in SCSI-3 
mode. Complete the procedure in Using SCSI-3. 

Keep the following in mind: 

• Secure Path 3. OF SP2 requires ACS 8.7 or later for use with SCSI-3 mode. Upgrade the 
HSG80 controllers to ACS 8.7 or later using the instructions in the Maintenance and 
Service Guide for Solution Software 8. 8 for HP-UX. 

The rolling upgrade method that upgrades ACS 8.7-3 to ACS 8.8 (described in the 
Maintenance and Service Guide for Solution Software 8.8 for HP-UX) fails if the server is 
running application I/O to the array that is being upgraded. You must quiesce all I/O to 
the array before starting the rolling upgrade procedure. 

5. Change the HSG80 operating system mode from HP to HP_VSA using the array's CLI interface 
(ACS 8.7 or later) by entering the following command: 

HSG80> show connections 

A connection table similar to the following is displayed: 

Connection Unit 

Name Operating system Controller Port Address Status Offset 
1NEWC0N13 HP OTHER 1 offline 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-CE61 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-CE60 
1NEWC0N14 HP OTHER 2 offline 0 
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HOST_ID=50 0 6-0B0 0-0 0 0 9-D8C7 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-D8C6 
INEWC0N15 HP THIS loffline 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-CE61 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-CE60 
INEWC0N16 HP THIS 2offline 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-D8C7 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-D8C6 

6. Using the connection name for the server that you are upgrading, change the operating system 
mode by entering the following commands: 

HSG80> set INEWC0N13 operating_SYStem=hp_vsa 

HSG80> set INEWC0N14 operating_system=hp_vsa 

HSG80> set INEWC0N15 operating_system=hp_vsa 

HSG80> set INEWC0N16 operating_system=hp_vsa 

7. Verify the change by entering the following command: 
HSG80> show connections 

The output looks similar to the following: 
Connection Unit 

Name Operating system Controller Port Address Status Offset 
INEWC0N13 HP_VSAOTHER 1 offline 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-CE61 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-CE60 
INEWC0N14 HP_VSAOTHER 2 offline 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-D8C7 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-D8C6 
1NEWC0N15 HP_VSA THIS loffline 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-CE61 ADAPTER_ID=50 0 6-0B0 0-0 0 0 9-CE60 
INEWC0N16 HP_VSA THIS 2offline 0 

HOST_ID=50 0 6-0B0 0-0 0 0 9-D8C7 ADAPTER_ID=500 6-0B00-000 9-D8C6 

Upgrading from the Web 

To upgrade your Secure Path for Active-Passive disk arrays software, access the upgrade package at: 
http://www.hp.com/country/ us/enq/ prodserv/storaqe.html . 

This package is intended as an upgrade only. The patch depot upgrades only Secure Path 3.0A, 3.0 
SP2, 3.0B SP2, 3.0C, 3.0D, 3.0E, 3.0F, or 3.0F SPl to 3.0F SP2. Therefore, you must install one of these 
revisions for the upgrade to succeed. 

Complete the following steps for a successful upgrade: 

1. Copy the upgrade tar package to a temporary directory (for example, /tmp). 

2. Unbundle the upgrade files by entering the following commands: 

# cd /tmp/Securepath 

# tar xvf sp v30FSP2_hp web. tar 

3. Verify that the directory contains the installation script install . sh and the following patch 
depots: 

HPswsp_v30FSP2 
CPQswsp_v30FSP2 

4. Install Secure Path software on the server using the provided shell script by entering the following 
command: 

# . /install . sh 

5. Select Secure Path Ver 3.0F SP2 for HP-UX for Active-Passive class of disk arrays when 
prompted. Follow the on-screen instructions. 

When the installation is complete and the server reboots, a subsequent swlist displays the following 
Secure Path output: 

# 
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# Product (s) not contained in a Bundle 

CPQswsp A. 3 . OF. 02F. OOF HP StorageWor ks Secure Path Device Driver, 
utilities, and upgrade patch for Active-Passive class of disk 
arrays . 



NOTE: 

If you are using the SCSI-2 protocol, the LUNs you see after the upgrade are the same ones you 
configured before the upgrade. If you are using SCSI-3 or are changing from SCSI-2 to SCSI-3, the 
LUNs you see after the upgrade are the ones you configured before the upgrade, followed by all LUNs 
(up to 127) that the server can see and claim for the array. 



Troubleshooting Secure Path for Active-Passive disk arrays 

You or on HP service representative can perform troubleshooting, depending on your HP service contract. 
If you are unable to resolve an error condition, ask your HP service representative for assistance. 

Table 11 lists Secure Path events, sample user notification messages, and sample syslog messages. 



Table 11 Secure Path Active-Passive event messages 



Event description 


User notification messages 


Syslog messages 


Occurs when array settings (such as 
load balancing, path verification, 
path verification period, auto-restore) 
are changed and there is a failure to 
update the persistent data of array 
settings in the kernel. 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed to 
retrieve/update the per- 
sistent data. May result 
in change/loss of Secure 
Path configuration/device 
settings across system 
reboots . 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed to 
update the persistent data 
for the Array 50001FE150 
003440. This may result 
in the loss of Secure Path 
configuration settings for 
this Array across system 
reboots 


Occurs when there is a failure in 
retrieving the persistent data of an 
array (like load balancing, path 
verification, path verification period, 
auto-restore) during boot. 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed to 
retrieve/update the per- 
sistent data. May result 
in change/loss of Secure 
Path configuration/device 
settings across system 
reboots . 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed to 
update the persistent data 
for the Array 50001FE150 
003440. This may result 
in the change of c#t#d# 
values of the LUNs config- 
ured on this Array across 
system reboots 


Occurs when you add LUNs using 
spmgr add or when you present 
new LUNs at the array after you 
run ioscan, and if there is a failure 
in updating the persistent data of 
the Secure Path Virtual LUN in the 
kernel. 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to retrieve/update the 
persistent data. May result 
in change/loss of Secure 
Path configuration/device 
settings across system 
reboots . 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to update the persistent 
data for the syslog set- 
ting. This may result in 
the loss of Secure Path 
log level settings across 
system reboots 


Occurs when the log settings are 
changed (such as syslog, console, 
and notify) and there is a failure to 
update the persistent data of these 
settings in the kernel. 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to retrieve/update the 
persistent data. May result 
in change/loss of Secure 
Path configuration/device 
settings across system 
reboots . 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to update the persistent 
data for the syslog set- 
ting. This may result in 
the loss of Secure Path 
log level settings across 
system reboots 
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Event description 


User notification messages 


Syslog messages 


Occurs when there is a failure to 
retrieve the persistent data of an 
array (like load balancing, path 
verification, path verification period, 
auto-restore) or a failure while 
retrieving the persistent data of the 
swsp interface nodes of the array. 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to retrieve/update the 
persistent data. May result 
in change/loss of Secure 
Path conf iguration/device 
settings across system 
reboots . 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to retrieve the persis- 
tent data for the Array 
50001FE150 003440. This 
may result in loss of Se- 
cure Path configuration 
settings for this Array. 
Also this may result in 
the change of c#t#d# val- 
ues of the LUNs configured 
on this Array 


Occurs when there is a failure in 
retrieving the persistent data of 
an array (like load balance, path 
verification, path verification period, 
auto-restore) during boot. 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to retrieve/update the 
persistent data. May result 
in change/loss of Secure 
Path conf iguration/device 
settings across system 
reboots . 


CPQswsp: Persistence 
error. Cause: Insuffi- 
cient system memory . Failed 
to retrieve the persis- 
tent data for the Array 
50001FE150 003440. This may 
result in loss of Secure 
Path configuration set- 
tings for this Array 


Occurs when there is a failure to 
retrieve the persistent data of the 
swsp interface nodes of the array 
during boot. 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 

system memory. Failed 
to retrieve/update the 
persistent data. May result 
in change/loss of Secure 
Path conf iguration/device 
settings across system 
reboots . 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 

system memory. Failed to 
retrieve the persistent 
data for the Array 500 
01FE150003440 . This may 
result in the change of 
c#t#d# values of the LUNs 
configured on this Array. 
Ignore this message if all 
the LUNs of this Array are 
deleted 


Occurs when there is a failure 
retrieving the persistent data of the 
LUN during boot. 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to retrieve/update the 
persistent data. May result 
in change/loss of Secure 
Path configuration/device 
settings across system 
reboots . 


CPQswsp: Persistence 
error. Cause: In- 
sufficient system mem- 
ory. Failed to retrieve 

the persistent data 
for the LUN 600508B400 
014 9200001 60 0000 5B0000. 
The LUN will be in un- 
mapped state till it is 
configured using ' spmgr 
add' followed by 'ioscan' 


Indicates there is a failure in setting 
or retrieving the persistent data in 
kernel. 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to retrieve/update the 
persistent data. May result 
in change/loss of Secure 
Path configuration/device 
settings across system 
reboots . 


CPQswsp: Persistence er- 
ror. Cause: Insufficient 
system memory. Failed 
to retrieve/update the 
persistent data. May result 
in change/loss of Secure 
Path configuration/device 
settings across system 
reboots 


Occurs when all the paths to the 
LUN have failed. 


All paths for Target/LUN 
0/2 (WWID=600508B4000 
149200001600000C00000) 
on Controller P4889B49IM 

failed. 


WARNING: CPQswsp: All 
paths for Target/LUN 
0/2 (WWID=600508B400 
014 90C00 01A0 00 01E2 00 00) 

on Controller P4889B49IM 
lallea 
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Event description 


User notification messages 


Syslog messages 


Occurs whsn o nsw LUN is oddocl 
or a quiesced LUN is restored to 
Secure Path. 


Availability for LUN 

60050 8B40 0014 90C0 001A00 001E 

changed to Alive. 


CPQswsp c Ava i 1 ab i 1 i t y 
2fieflOLUN 600508B40001490C0 
001A00001E20000 changed to 
Alive 


Occurs when the path to the end 
LUN has failed. 


Path c42t0d2 Failed (LUN 
600508B400014 90C0 001A00 001E 
Controller P4889B49IM 
Array . 


CPQswsp: Path 
2(e«Bf)0d2 Failed (LUN 
60050 8B4000 14 90C0 
001A00001E20000 Con- 
troller P4889B49IM Array 
50001FE100150AE0 HBA td3) 


Occurs when a path to the end LUN 
has either quiesced the controller or 
HBA connecting to that LUN, or LUN 
has failed. 


Availability for LUN 
600508B400014 90C0001A00001E 
changed to Dead. 


WARNING: CPQswsp: 
2S'0Si)lability for LUN 
600508B400014 90C0001A0000 
1E20000 changed to Dead 


Occurs when ioscon is executed 
in parallel to the spmgr delete 
command. 




CPQswsp: Aborting 
scanning of Secure Path 

devices due to other 
outstanding Secure Path 
operations. Please 

reissue ioscan command to 


Occurs when there is ore no 
free c#t#d# values available for 
mapping the LUN. 




CPQswsp: Mapping 
error. Cause: No free 
c#t#d# available for 
mapping for the unit 
600508B400014 92 00001600000 
5B0000. The unit will be 
kept in the unattached 
list. To map this 
unit, clean up any 
stale undiscovered units 
present using ' spmgr clean 
[option] ' and run ioscan 


Occurs when there is a failure in 
allocating memory required for the 
swsp node creation. 




CPQswsp: Allocation 
error. Cause: Failed 
to allocate memory for 
the ' swsp' node of the 
unit 600508B4000149200 
0016000005B0000 . The 
unit will be kept in the 
unattached list. To map 
this unit, free up memory 
and run ioscan 


Occurs usually when the unit which 
was deleted in the previous boot 

using the spmgr delete command is 
not discovered during boot scan of 
this session. 




CPQswsp: The 

unit 600508B400 

014 92 000016000005B0000 

is not discovered and not 

associated with any of the 
discovered Arrays. So the 
persistent data of this 
unit will be deleted 


Occurs when there is on error 
in reading the persistent data of 
the LUN and which resulted in 
associating this LUN's persistent 

UUIU W 1 1 M IMC Wl LIMU UllUy. 




CPQswsp: Mapping error. 
Cause: Error in reading 
the persistent data 
in the previous boots . 
This will result in the 
change of c#t#d# value 
of the LUN 600508B400 
014 92 00001 6000005B0000 
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Event description 


User notification messages 


Syslog messages 


Occurs when there is an error 
reading the persistent data of the 
interface node of the array in the 
previous boots and thus allowing 
some other interface node to get 
the same h/w address value. In 
the subsequent boot, if the first 
interface node's persistent data is 
read properly, then there is more 
than one interface node having the 
same h/w address value, which 
results in duplicate entries. 




CPQswsp: Mapping error. 
Cause: Due to error in 
reading the persistent 
data in the previous 
boots, there are duplicate 
entries for the swsp 
h/w address 2. This may 
result in the change of 
c#t#d# values of the LUNs 
configured for the above 
h/w address on the Array 
50001FE150003440 


Occurs when there is an error 
reading the persistent data of the 
LUN in the previous boots and thus 
allowing some other LUN to get 
the same c#t#d# value. In the 
subsequent boot, if the first LUN's 
persistent data is read properly, then 
there is more than one LUN having 
the same c^t^d^ value, which results 
in duplicate entries. 




CPQswsp: Mapping 
error. Cause: Due to 
error in reading the 
persistent data in the 
previous boots, there 
are duplicate entries 
for the mapping data of 
hw addr 2, target 1, lun 
0. This may result in 
the change of c#t#d# value 
of the LUN 600508B400 
014 9200001 60 00005B0000 


Occurs when the spmgr delete 
command is executed on an EVA 
LUN which is configured as the 
system dump device (for HP-UX 
lliV2.0 only). 




CPQswsp: spmgr delete 
Operation Error. 
Cause: 600508B40001492 
000016000005B0000 not 
deleted, is a dump device 


Occurs when a device is unpresented 
before deleting the device with the 
spmgr delete command, and you 
add new device with the same 
virtual disk or unit number as the old 
device, as the new device is bound 
to the VAVLUNID of the old deleted 

npvirp Thi^ pnvp^ tnP npw v nnnpn 

LUN in an inconsistent state. 




Multiple luns [ lun: 
<WWLUNID> & lun: 
<WWLUNID>] present at 
target/lun [ target ]/[ lun ] 
on array <array WWN> . 
To obtain proper data 
ensure the c#t#d# at 
the specified target and 
lun is not busy/mounted 
and Run ioscan & insf -e 
respectively. ^ 



^This message appears only if you hove enabled the path polling. 



Table 12 describes the way that Secure Path reports an event, such as a failure or state change to the 
server through the Secure Path driver (hsx) or agent (spagent). 

The Response action column shov/s v/here the event is logged. 

• LOG is the /var/adm/syslog/syslog . log file. 

• CONSOLE is the root console. 

• NOTIFY is e-mail notification. 

The Level column indicates the criticality of the event and is used by spmgr to allov/ the system 
administrator to route events to specific users. 
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Table 12 Responses and severity level for supported events 



Event 


Response action 


Level 


Path failed 


LOG+CONSOLE+NOTIFY 


WARNING 


Failover condition detected 


LOG+CONSOLE+NOTIFY 


CRITICAL 


Failover start 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


Failover complete 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


Restore start 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


Rpctorp ("omn ptp 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


KpQtnrp fni pH 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


Excessive restores 


LOG+CONSOLE+NOTIFY 


\A/ARNING - niitn-rp<;tnrp i<; di<;nhlpd 
until next time quantum (1 hour) 


Availability changed 


LOG+CONSOLE+NOTIFY 


CRITICAL 


Select start 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


Select complete 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


Select failed 


LOG+CONSOLE+NOTIFY 


WARNING 


Unit attention 


LOG 


INFORMATIONAL 


Secure Path started 


LOG+CONSOLE 


INFORMATIONAL 


Configuration change 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


Active path changed 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


New LUN added 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


New path added 


LOG+CONSOLE+NOTIFY 


INFORMATIONAL 


Path verification On/Off changed 


LOG 


INFORMATIONAL 
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2 Secure Path for Active-Active disk 
arrays 



HP StorageWorks Secure Path 3. OF SP2 for Active-Active disk arrays provides automatic I/O path 
failover, failback, recovery, and load balancing for host systems configured with multiple host adapters 
and connections to disk arrays. 

This chapter describes the following: 

• Features 

• ULM services 

• I/O load balancing 

• Online device discovery 

• Installing Secure Path for Active-Active disk arrays 

• Upgrading from the Web 

• Removing Secure Path 

• Command line interface 

• Troubleshooting Secure Path for Active-Active disk arrays 

Features 

Secure Path for Active- Active disk arrays provides enhanced data availability with the following features: 
NOTE: 

The autopath recover command has been replaced with the autopath monitor command, in 
Secure Path 3.0F SP2. 



• Automatic path failover to an alternate path 

• Automatic path recovery after failed path is serviced 

• I/O load balancing over multiple paths 

• Command line interface (CLI) for Secure Path management 

• Ability to reestablish previous load balancing policy after reboot through the CLI 

• Ability to discover the SAN configuration changes (such as addition or deletion of devices and 
paths) without rebooting 

• SAN boot support for Secure Path Active-Active devices, if configured under LVM 

• Ability to retry the failed I/O on non-LVM VxFS devices 

• Supports array, array type, and LUN exclusion or inclusion for Active-Active devices 

• Supports up to 32 paths to an end LUN 

• Allows the coexistence of Active-Passive disk arrays and Active-Active disk arrays 

• Connects the Active-Passive disk arrays and the Active-Active disk arrays using the same set of 
HBAs 

• Support for Virtual Device Special File (referred as "vdsf" throughout this guide) 
for each LUN under Secure Path's control that are not configured under HP LVM to provide 
high-availability access to raw devices 

• Includes a new autopath virtualdsf command to create virtual device files for the LUNs 
under Secure Path's control 
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• Includes a new autopath monitor command to start the monitor deamon to control the 
fail-back and pro-active path monitor features for faster path failover and recovery. 

• Supports high-availability dump device on HP-UX 11 i v2.0 systems 

• Supports interoperability v/ith VxVM 4.1 on Hi v2.0 systems 

• Supports rerouting VxVM based l/O's. The I/O is returned to VxVM only on an All Paths 
Failed condition 

• Supports periodic path polling to check the path state changes 

• Supports read optimization with asymmetric EVA Active-Active arrays to increase the I/O 
performance 

• Supports addition or deletion of EVA arrays using the array WWN and for XP arrays using 
the array ID 

Secure Path 30F SP2 does not support all the new features on VA group of arrays. See HP StorageWorks 
Secure Path 3.0F Service Pack 2 for HP-UX 7 7/ vl.O and 7 7/ v2.0 release notes for more information. 



& IMPORTANT: 

You must disable the VERITAS DMP multipath feature on a Secure Path owned device, or remove 
the device from Secure Path's control by running the autopath delete command to avoid 
interoperatebility issues with VxVM 4.1 and Secure Path 3.0F SP2 on HP-UX 11 i v2.0. 



The HP StorageWorks Secure Path software performs dynamic load balancing of data flow through 
multiple paths. It detects multiple paths to each logical device and distributes the data load among 
the paths for optimum performance. 

The user interface lets a system administrator define load balancing policies and preferred paths and view 
device path information. Secure Path manages paths according to the load balancing policy, ensuring 
that no single path is a performance bottleneck. 

To configure the high-availability dump device on your HP-UX 11 i v2.0 systems, you must not use a device 
path that has failed even if it has alternate active device paths. If the dump device patch is not installed 
and the autopath discover command is run, warning messages are displayed in the syslog. 

You cannot delete an array or array type, if a LUN of the array: 

• Is mounted with failed paths, or 

• Is open or configured as a dump device. 

In such cases, to delete the array or array type, do either of the following: 

1. Run the autopath delete - a <array ID> command after restoring the LUNs on the array. 
NOTE: 

Use caution before running the autopath delete - a <array ID> command. The persistence 
of all LUN parameters on the array is lost after you run the autopath delete -a <array ID> or 

autopath delete -r <array type> command. 



2. Run the autopath discover command to restore the LUNs on the array. 



NOTE: 

All persistent data are moved to KRS from the /opt/perset data file. 



The vdsf is a link to the physical path of the device configured under HP LVM and dynamically points to 
the next active path of the device (when the configured primary path fails and the system reboots). 
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All the Secure Path commands except autopath add command, supports vdsf as a command 
argument and provides all the operations of Secure Path commands. 

The vdsf is created under the /hpap/dsk/ directory for block device access, and under the 
/hpap/rdsk/ directory for raw device access. 

The vdsf is in the format of hpapX, where X is a positive integer starting from 0. 

The persistence of vdsf associated with a LUN is lost, if the LUN, array, or an array type is deleted 
from Secure Path's control. New vdsf is assigned when you add the deleted LUN back under Secure 
Path's control. 

The autopath add <VDSF> command is not supported in this release of Secure Path.. 



ULM services 

Secure Path uses the SCSI Upper Layer Module (ULM) interface to provide flexible configuration and 
layering of modules above the SCSI disk drivers. 

If you are configuring Secure Path into HP-UX 11 i vl.O 64-bit operating systems and want it to coexist 
with other pseudo drivers, register Secure Path with the ULM services for each LUN path you want the 
Secure Path to control. 

I/O load balancing 

This section describes the following: 

• Automatic failover 

• Automatic path recovery 

• Pro-active path monitor 

Secure Path performs I/O load balancing while monitoring each path to ensure that the I/O transaction 
is completed. The load balancing policy is selected by the administrator. 

The I/O load balancing policy prevents any path from becoming overloaded, and it helps to prevent the 
congestion that occurs when many I/O operations are directed to common devices along the same path. 

If a preferred path is used for a device, the entire I/O for that particular device flows through the preferred 
path and no load balancing is done by Secure Path for that device. 

Automatic failover 

In the event of a failure of any part of a path between the disk arrays and a server. Secure Path 
automatically switches to an alternate path, dropping the failed path out of the I/O rotation without any 
loss of data. The failover is not visible to applications, so normal operation continues without downtime. 

When automatic failover happens it also triggers active path monitoring across all active paths in the 
sub-system, to ensure that all path failures in the sub-system are detected at once. 

For troubleshooting information, see Troubleshooting Secure Path for Active-Active disk arrays. 

Automatic path recovery 

V^hen a path fails, it is no longer used. After the path has been repaired and returned to normal. 
Secure Path automatically begins using the path with the designated load balancing policy. No user 
action is necessary. 
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Pro-active path monitor 

The pro-active path monitor feature, if enabled, ensures that the status of the path is automatically 
changed to Failed state from its original Active state, if path failure has occurred in that path. It also 
ensures the correct path status for all the active paths in every path verification interval. You can set the 
parameter for the path verification interval using the autopath set command.. 

Online device discovery 

if there are any changes in the SAN configuration such as addition or deletion of paths or devices, these 
changes can be updated in Secure Path for Active-Active arrays for maximum and efficient utilization of 
resources. 

The autopath discover command updates the SAN configuration changes to the list of Secure Path 
for Active-Active devices without a system reboot. 

Discovery of new path or LUN is effective only if you execute ioscan and insf -e before executing 

the autopath discover command. 



Installing Secure Path for Active-Active disk arrays 

This section describes the minimum system requirements and procedures for installing Secure Path for 
Active-Active disk arrays, including: 

• System requirements 

• Installing Secure Path 

• Installing Secure Path on a SAN boot device 

You must have root account privileges to install Secure Path software. 



System requirements 

To install Secure Path, your system must conform to the following requirements: 

• HP-UX OS 11 i vl.O or 11 i v2.0 64-bit operating system 

• Administrator root access to the host system 

• SCSI ULM Services B.11.11.01 for HP-UX 11 i vl.O 

For specific installation requirements for your system, contact your HP account representative. 



m NOTE: 

See the HP StorageWorks Secure Path 3.0F Service Pack 2 for HP-UX Hi vl.O and Hi v2.0 release 
notes for details about the supported configuration. 
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Installing Secure Path 

Before installing Secure Path on HP-UX Hi vl.O, ensure that SCSI ULM services are installed on your 
system. 

& NOTE: 

To install Secure Path, you must have superuser (root) access on the HP-UX host. 



To install Secure Path, complete the follov/ing steps: 

1. Log on to the HP-UX system as superuser (root). 

2. Insert the Secure Path installation CD-ROM into the CD-ROM drive. 

3. Mount the CD-ROM on your file system. 

4. Change to the directory in which the CD-ROM is mounted. For example, if the CD-ROM is 
mounted to a directory called /cdrom, change the directory by entering the following command: 

# cd /cdrom/ 

5. Install Secure Path software on the server by entering the following command: 

# . /install . sh 

6. Select Secure Path 3.0F SP2 for HP-UX for Active-Active disk arrays when prompted. Follow 
the on-screen instructions. 



^ NOTE: 

If AutoPath 2.x is installed, Secure Path 3.0F SP2 for Active-Active disk arrays removes AutoPath 2.x, 
installs 3. OF SP2, and then reboots. A single reboot brings up the system with Secure Path 3. OF SP2 
for Active-Active disk arrays (only for 11 i vl.O). 



When the installation is complete, the server reboots (HP-UX 11 i vl.O only). Installation of the Secure 
Path package creates the /Autopath and /HPswsp directories under the /opt directory. The 
changes.log file is copied into the /Autopath directory, and the master, system, and mod.o 
files are copied into the /HPswsp directory. 

Installing Secure Path on a SAN boot device 

Complete the following steps to install Secure Path for the first time on a SAN boot device: 

1. Install HP-UX 11 i vl.O or 11 i v2.0 on the Active-Active disk arrays LUN and boot the system. 

2. Install Secure Path on the boot LUN. 

3. Configure LVM with alternate physical volume paths to the primary boot volume path. 

4. Use the vgextend command to record alternate paths to the primary boot volume path by 
entering the following command: 

# vgextend /dev/vgOO alternate physical device path 
Example: 

# vgextend /dev/vgOO /dev/dsk/cl4tOdl /dev/dsk/cl6t0dl 
/dev/dsk/cl8t0dl 

The vgextend command extends the root volume with alternate paths. 

5. Use the setboot command to modify the boot variables and to set alternate paths to the 
boot LUN by entering the following command: 

# setboot -a hw_path_of_alternate_boot_path 
Example: 

# setboot -a 0/0/2/0.2.1 
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Upgrading from the Web 

To upgrade your Secure Path for Active-Active disk arrays software, access the upgrade package at 

http://www.hp.com/ country/ us/ enq/ prodserv/storaqe.html . 

This package is intended as an upgrade only. The patch depot upgrades AutoPath 2.xx.xx or Secure Path 
3.0x to Secure Path 3.0F SP2. 

Complete the following steps for a successful upgrade: 

1. Copy the upgrade tar package to a temporary directory (for example, /trap). 

2. Unbundle the upgrade files by entering the following commands: 

# cd /tmp/Securepath 

# tar xvf sp v30FSP2 hp web. tar 

3. Verify that the directory contains the installation script install . sh and the following directories: 

HPswsp_v30FSP2 
CPQswsp_v30FSP2 

4. Install Secure Path software on the server using the provided shell script by entering the following 
command: 

# . /install . sh 

5. Select Secure Path 3.0F SP2 for HP-UX for Active-Active disk arrays when prompted. Follow 
the on-screen instructions. 

When the installation is complete and the server reboots (for HP-UX 11 i vl.O only, or you are 
upgrading from Autopath 2.0), a subsequent swllst displays the following Secure Path output: 

# 

# Product (s) not contained in a Bundle 

HPswsp A. 3 . OF . 02F. OOF HP StorageWor ks Secure Path Device 
Driver and utilities for Active-Active disk arrays. 

6. Run the autopath discover and autopath retrieve command to complete the upgrade 
and to get all the persistence settings. 



NOTE: 

Configuration setting are migrated across upgrades only for 3. OF and later releases. The configuration 
settings are lost while migrating from versions prior to Secure Path 3. OF. 



NOTE: 



For XP arrays: In Secure Path 3. OF SPl, the autopath display command used to display the array 
ID differently from 3. OF SP2. In Secure Path 3. OF SPl, the array ID is displayed as a hexadecimal (2747) 
value and in Secure Path 3.0F SP2 it is displayed as decimal (1005-5) value. 



Removing Secure Path 

You can remove Secure Path by using the HP SD utility. When you remove Secure Path, all files (including 
configuration files) are removed. 
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Complete the steps below to remove Secure Path from your system: 

1. Log on to the HP-UX system as superuser (root). 

2. Run the swremove command from the command line as follows: 

# swremove -x autoreboot=true HPswsp (for HP-UX 11 i vl.O) 

# swremove HPswsp (for HP-UX 11 i v2.0) 

3. Alternatively, you can launch the interactive session of swremove and the select HPswsp HP 
StorageWorks Secure Path Driver and Utilities for Active-Active disk arrays product for removal. 

The system reboots after removal is completed (HP-UX 11 i vl.O only). 

Command line interface 

You can use the Secure Path command line interface (CLI) only on those hosts that are connected to 
devices with the HPswsp driver installed. 

This section contains information about the commands supported by this interface along with their 
syntax, including: 

• autopath delete command 

• autopath add command 

• autopath set command 

• autopath display command 

• autopath virtualdsf command 

• autopath monitor command 

• autopath help command 

• autopath discover command 

• autopath retrieve command 

• autopath setjbpolicy command 

• autopath set prefpath command 

autopath delete command 

The autopath delete command deletes a device, LUN, array, or an array type from Secure Path's control. 
This command succeeds only if the LUN is not busy (for example, when there is no I/O happening and 
when the LUN is not mounted or open). 

You can also use the autopath delete command to remove those LUN, array, or an array type that 
are added to the configuration, but not discovered by Secure Path. This avoids the discovery of LUN, 
array, or an array type while the autopath discover command is run. 

Once you run the autopath delete command, the virtual device file of the deleted device is 
disassociated from the LUN. 

Syntax: 

• autopath delete <device path | {option} {ARRAYID | WWLUNID | Array Type}> 

description: delete LUN/Array ID/Array-Type from the SecurePath' s control 
Usage: 

autopath delete <device path | {option} {ARRAYID | WWLUNID | Array Type}> 

device path : device special file e . g . /dev/dsk:/c#t#d# or /hpap/dsk:/hpap# 
option : 

-1 -- for entering the WWLUNID 
-a -- for entering the Array ID 
-r -- for entering the Array Type 
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WWLUNID : World Wide Node Name of the LUN 

Array Type : Array Type ( XP/VA/EVA-AA) 

device path is either the primary path or alternate path of the device. 

Deleted LUNs are no longer under Secure Path control; this setting is persistent across reboots. 

Deleted LUNs are listed in the unattached list of Secure Path Active-Active arrays. The unattached list 
maintains the WWNs of all deleted LUNs. You can view this list by entering the following command: 

autopath display -u 

Persistence data, like load balancing policies are not kept persistent for deleted LUNs. When a LUN is 
deleted, persistent data maintained for that LUN is removed. 

You can delete a LUN by specifying the device path, vdsf, or LUN WWID as an argument in the 
delete command, as shown below: 

• Deleting a LUN using the device path: 

• Syntax: 

autopath delete <devlce path> 

• Example:: 

autopath delete /dev/dsk/cOtOdO 

• Deleting a LUN using the LUN WWID: 

• Syntax: 

autopath delete -1 <LUN WWID> 

• Example:: 

autopath delete -1 6005-08B4-0001-499C-0002-0000-0005-0000 

• Deleting an array using the array type: 

• Syntax: 

autopath delete <array type> 

• Example:: 

autopath delete -r EVA-AA 



NOTE: 

The autopath delete command fails if: 

• Device is configured under crashconf (dump). 

• A failed device is opened or mounted. 



autopath add command 

The autopath add command removes the deleted LUN, array, or an array type from the Secure Path 's 
unattached list, and the autopath discover command following this, adds the deleted LUN, array, 
or the array type back to Secure Path's control. You can add only those LUN, array, or an array type 
(using the autopath add command followed by the autopath discover command) that you have 
deleted using the autopath delete command. 

The autopath add command enables addition of a LUN, array, or an array type from the unattached 
list to the Secure Path device's list. Secure Path regains the control of the LUN, array, or the array type 
only after you execute the autopath discover command. 

Syntax: 

autopath add < device path | {option} {WWLUNID | Array Type} > 

description: add a LUN/Array-Type to SecurePath' s control. Addition will happen only after executie 
usage : 

autopath add < device path | {option} {WWLUNID | Array Type} > 
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device path : device special file e . g . /dev/dsk/c#t#d# 



option : 

-1 — for entering the WWLUNID 

-a -- for entering the Array 

-r -- for entering the Array Type 

WWLUNID: — World Wide Node Name of the LUN 

Array Type: -- Array Type ( XP/VA/EVA-AA) 



Example: 










autopath 


add 


-1 


<LUN WWID> 




autopath 


add 


-1 


6005-08B4-0001- 


499C 


autopath 


add 


-r 


<array type> 




autopath 


add 


-r 


EVA-AA 




autopath 


add 


-a 


<array ID> 




autopath 


add 


-a 


5005-08B3-0091- 


15A0 



The autopath add command succeeds even if the LUN is in use. This command removes the LUN 
WWID entry from the unattached list. 

autopath set command 

The autopath set command sets the configuration parameters, including the load balancing policy, 
retry timeouts, path verification interval, and read optimization for a Secure Path device. 

Syntax: 

autopath set -1 <WWID> -b policy | -t pathname <value> I -r <arraytype> -o 
[option] I -a <arrayID> -o [option] | -a <arrayID> -p <interval> 

description : set Secure Path configuration parameters 

usage : 

autopath set {option} 
options : 

-1 <WWID> -b <policy name>-sets load balancing policy for the LUN 

WWID : World Wide Node Name of the LUN 

Policy name: the load balancing policy to set 

valid policies are 



RR 

SST 

SQL 

NLB/OFF 



Round Robin. 
Shortest Service Time . 
Shortest Queue Length. 
No Load Balancing. 



-t <device path> <value>-sets time out value for the LUN 
device path: device special file e . g . /dev/dsk:/c#t#d# 

value : 

-1 : infinite retry (default) 
0 : abort immediately on all paths fail condition 
1-86400 : timeout period in seconds 

-r <array type> -o <ON/OFF> - set/unset read optimization flag or the array type 
valid array types are: 

EVA-AA : All EVA Active-Active arrays. 

-a <ArrayID> -o <ON/OFF> - set/unset read optimization flag for the array id 
ArraylD : Identifier for the array 

-a <ArrayID> -p <interval> - set path verification period the array 

ArraylD : Identifier for the array 

interval : Path verification interval to set 

valid range for path verification interval are 
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OFF - 00:00 Minutes 
ON - 00:01 to 24:00 hours 
(00:10 minutes is the default) 



Example: 



# autopath set -1 60 05-0 8B4-00 01-4 99C-00 01-FOO 0-01 63-0 00 0 -b sql 

# autopath set -t /dev/dsk/cl 60t0dl 86400 

# autopath set -r EVA-AA -o OFF 

# autopath set -a 5000-1FE1-0027-0CF0 -o ON 

# autopath set -a 5000-1FE1-0027-0CF0 -p 00:50 



NOTE: 

The pro-active path monitoring feature gets triggered whenever an automatic path failover happens for 
all the arrays, even though the feature is disabled for one or all the arrays. 



i' NOTE: 

• Secure Path 3. OF SP2 supports Infinite Retry for VxFS file systems only. 

• If the file system changes from VxFS to HFS, the autopath set -t command v/ill not work. 
The HFS file system defaults remain in effect. 

• If a device configured under the HFS file system encounters an All Paths Fail condition, I/O restarts 
only if the path on which original I/O is sent down is active. 



utopath display command 

The autopath display command displays details about Secure Path devices, such as alternate paths 
to a Secure Path device, associated status, and load balancing policy settings. 



m NOTE: 

For XP arrays: In Secure Path 3. OF SPl, the autopath display command used to display the array 
WWN differently from 3.0F SP2. In Secure Path 3.0F SPl, the array WWN is displayed as a hex (2747) 
value and in Secure Path 3.0F SP2 it is displayed as decimal (1005-5) value. 



This section contains the following information about the autopath display command: 

• List of all arrays connected to a host 

• Details of all LUNs connected from an array 

• Display autopath discover status 

• List of array controllers connected to the host 

• List all LUNs in the unattached list 

• Display LUN info using a device path 

• Display LUN info using a LUN WWID 

• Display all LUNs connected to the host 

of all arrays connected to a host 

The autopath display -r command displays a list of all arrays connected to the host. 
Syntax: 

autopath display -r 
Example: 

#autopath display -r 
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HPswsp Version 



A.3.0F.02F.00F 



Array IDs 

060B-0000-14E2-E050 
060B-0000-1534-1C50 



Details of all LUNs connected from an array 

The autopath display -r <Array ID> command displays details of all LUNs connected from 
array. 

Syntax: 

autopath display -r <Array ID> 
Example: 

# autopath display -r 500 O-lFEl-5002-38 90 



HPswsp Version : A. 3 . OF. 02F. OOF 


Auto Discover 


OFF 


Array Type 

Array WWN 

Read Optimize 

Path Verification Peric 


EVA-AA 

5000-1FE1-5002-3890 
ON 

3d : 00:10 


Lun WWN : ( 
Virtual Device File 
Load Balancing Policy 
Lun Timeout 


50 05-0 8B4-00 01-2 8B9-00 01-900 0-00 07-0 00 0 
/hpap/ dsk/hpap5 
No Load Balancing 
Infinite Retry (-1) 


Device Path 


Status 


/dev/dsk/c8t0dl 
/dev/dsk/clOtOdl 
/dev/dsk/cl6t0dl 
/dev/dsk/cl8t0dl 


Active 
Active 
Active 
Active 



Display autopath discover status 

The autopath display command displays the status of the discover settings for the array. 



Syntax: 




phsdp3# autopath 


display |more 


HPswsp Version 


: A.3.0F.02F.00F 


Auto Discover 


: ON 


Array Type 


: EVA-AA 
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Array WWN : 5000-1FE1-0027-0CF0 

Read Optimize : ON 

Path Verification Period : 00:10 



List of array controllers connected to the host 

The autopath display -c command displays a list of controllers connected to the host. 
Syntax: 

autopath display -c 
Example: 

# autopath display -c 



HPswsp Version 


: A. 3 . OF. 02F. OOF 


Array ID 


: 060B-0000-14E2-E050 


Controller Ids 


OPRO-2195-2880 




OPRO-2195-0720 




Array ID 


: 060B-0000-1534-1C50 


Controller Ids 


OPRO-2208-1550 




OPRO-2208-1700 





List all LUNs in the unattached list 

The autopath display -u command displays a list of all LUNs in the unattached list. 



Syntax: 




autopath display -u 




Example: 




# autopath display -u 




HPswsp Version 


: A. 3 . OF. 02F. OOF 


Excluded Array Types 


: EVA-AA 




Deleted Arrays 



Array ID Array Type 



84 Secure Path for Active-Active disk arrays 



5000-1FE1-5000-B5D0 



EVA-AA 



Array Type : EVA-AA 

Array ID : 5000-1FE1-0027-0CF0 

Deleted Luns 

60 05-0 8B4-0010-0F1 7-00 01-0 00 0-00 91-0 00 0 



Display LUN info using a device path 

The autopath display <device path> command displays LUN info of the LUN using the device 
path. 

You can also use vdsf (in place of device path) in the autopath display command to display 
the LUN info of the LUN. 



Syntax: 




autopath display <device 


path> 


Example: 




aphn5# autopath display 


/dev/dsk/c60tld0 


HPswsp Version : 


A.3.0F.02F.00F 


Array WWN : 


5005-08B3-0091-16A0 


Lun WWN : 


60 05-0 8B3-00 91-1 6A0-BFA5-F0A6-7FCE-0 0 64 


Virtual Device File : 


/hpap/ dsk/hpap62 


Load Balancing Policy : 


Shortest Service Time 


Lun Timeout : 


Infinite Retry (-1) 


Device Path 


Status 


/dev/dsk/c59tld0 


Active 


/dev/dsk/c60tld0 


Active 



Display LUN info using a LUN WWID 

The autopath display -1 <LUN WWID> command displays LUN info of the LUN using the LUN 
WWID. 

Syntax: 

autopath display -KLUN WWID> 
Example: 

aphn5# autopath display -1 60 05-0 8B3-00 91-1 6A0-BFA5-F0A6-7FCE-0 0 64 
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HPswsp Version 



A. 3 . OF. 02F. OOF 



Array WWN : 5005-08B3-0091-16A0 



Lun WWN 


600 5-08B3-0 0 91-16A0-BFA5-F0A6-7FCE-00 64 


Virtual Device File 


/hpap/dsk/hpap62 


Load Balancing Policy 


Shortest Service Time 


Lun Timeout 


Infinite Retry (-1) 


Device Path 


Status 


/dev/dsk/c59tld0 


Active 


/dev/dsk/c60tld0 


Active 



Display all LUNs connected to the host 

The autopath display [all] command displays details about all LUNs connected to the host. 
Syntax: 

autopath display 
autopath display all 



Example: 

# autopath display 


HPswsp Version 


A. 3 . OF. 02F. OOF 


Auto Discover 


ON 


Array Type 

Array WWN 

Read Optimize 

Path Verification Peric 


EVA-AA 

5005-08B3-0091-16A0 
ON 

3d : 00:10 


Lun WWN 

Virtual Device File 
Load Balancing Policy 
Lun Timeout 


600 5-08B3-0 0 91-1 6A0-F33F-37 7A-FB98-00 5F 
/hpap/dsk/hpap6 
Shortest Queue Length 
Infinite Retry (-1) 


Device Path 


Status 


/dev/dsk/c52t0d0 
/dev/dsk/c51t0d0 


Active 
Active 





Lun WWN : 6005-08B3-0091-16A0-6328-4F90-E473-005F 

Virtual Device File : /hpap/dsk/hpap7 

Load Balancing Policy : Shortest Queue Length 

Lun Timeout : Infinite Retry (-1) 



Device Path 


Status 


/dev/dsk/c52t0dl 


Active 


/dev/dsk/c51t0dl 


Active 




86 Secure Path for Active-Active disk 


arrays 



Lun WWN : 60 0 5-0 8B3- 0 0 91 -1 6A0- 9C8 8 -8 8A5- 57 8E-0 0 6 0 

Virtual Device File : /hpap/dsk:/hpap8 

Load Balancing Policy : Shortest Queue Length 

Lun Timeout : Infinite Retry (-1) 



Device Path 


Status 








/dev/dsk/c52t0d2 
/dev/dsk/c51tOd2 


Active 
Active 










Lun WWN 

Virtual Device File 
Load Balancing Policy 
Lun Timeout 


60 05-0 8B3-00 91-16A0-28 66 
/hpap/ dsk/hpap9 
Shortest Queue Length 
Infinite Retry (-1) 


-56B7- 


08F4- 


0060 


Device Path 


Status 








/dev/dsk/c52t0d3 
/dev/dsk/c51t0d3 


Active 
Active 










Lun WWN 

Virtual Device File 
Load Balancing Policy 
Lun Timeout 


60 05-0 8B3-00 91-1 6A0-4 6E0 
/hpap/ dsk/hpaplO 
Shortest Queue Length 
Infinite Retry (-1) 


-26C5- 


31AD- 


0061 


Device Path 


Status 








/dev/dsk/c52tOd4 
/dev/dsk/c51t0d4 


Active 
Active 









autopath virtualdsf command 

The autopath virtualdsf command creates and updates the virtual device special files for the LUNs. 
Syntax: 

tautopath virtualdsf [clean] 

The virtual device files are created for all the LUNs under Secure Path's control. The virtual device files 
for all the undiscovered, deleted, and collided LUNs gets deleted. 

The virtual device special file is a link to the physical path of the device configured under HP LVM and 
dynamically points to the next active path of the device (when the configured primary path fails and 
the system reboots), provided the auto-discovery is set to ON. If auto-discovery is set to its default OFF 
value, you must run the autopath discover command to update the virtual device files to point to 
the alive paths. 

The autopath virtualdsf command is different from the autopath discover command, 
because, it does not discover any new LUNs. It only creates the device special files for the LUNs that are 
already under Secure Path's control. 



NOTE: 

You cannot use the virtual device file with the autopath add command or when configuring the 
device under HP LVM. 
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autopath virtualdsf clean command 

The autopath virtualdsf clean command releases the virtual device files allocated for the 
LUNs that are deleted from Secure Path's control. 

If you run the autopath delete command to remove a LUN from Secure Path's control, the LUN is 
disassociated from its virtual device special file. However, the virtual device file alias associated v/ith the 
deleted LUN is reused for a new LUN only if you run the autopath virtualdsf clean command. 

Syntax: 

# autopath virtualdsf clean 
Example: 

AUTOPATH: The virtual alias hpap258 is freed and would be reused 
AUTOPATH: The virtual alias hpap259 is freed and would be reused 

The alias hpap2 5 8 and hpap2 5 9 in the above example belong to the LUN's that are removed from 
Secure Path's control using the autopath delete command. 

autopath monitor command 

The autopath monitor command activates the automatic path recovery and pro-active path 
monitoring process automatically during system reboot. You can invoke the automatic path recovery 
and pro-active path monitoring feature from the command line, if it is not invoked automatically or is 
terminated. 

Syntax: 

# autopath monitor 

description : starts the monitor deamon to control the fail-back and pro-active 
path monitor features 



NOTE: 

For more information, see I/O load balancing 



autopath help command 

The autopath help command lists all of the autopath commands. It also displays syntax of an 
autopath command and its usage. 

Syntax: 

# autopath help [command] 
Example: 

# autopath help 



usage: autopath <command> 
command : 

add : 



delete 
discover 

display 
set 

set_lbpolicY 
set_prefpath 
retrieve 



add a LUN/Array-Type to SecurePath's control. Addition 
will happen only after execution of 
'autopath discover' command 

delete LUN/Array-Type from the SecurePath' s control 

discover the newly added device (s) and also recognize 

the status of old device 

display accessible storage information 

set SecurePath configuration parameters 

set load balancing policy 

set preferred path 

retrieve the persistence setting 
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recover 
help 



start the recover deamon to recover the failed devices 
display this help message 



Example: 

# autopath help discover 

description: discover the newly added device and also recognize 
the status of old device 



usage : 

autopath discover [option] 



options : 

ON : Enable the auto discover devices feature 

OFF : Disable the auto discover devices feature 



Example: 

# autopath help add 

description: enables addition of a LUN from unattached-list to 
Secure Path's device list. LUN is brought under Secure Path's 
controlonly after execution of the autopath discover command 



usage : 

autopath add {option} {device path | WWLUNID | Array Type} 
option : 

-1 -- for entering the WWLUNID 

-r -- for entering the Array Type 

device path : -- device special file e . g . /dev/dsk/c#t#d# 

WWLUNID : — World Wide Node Name of the LUN 

Array Type : — Array Type ( XP/VA/EVA-AA) 



Example: 

# autopath help delete 

description: delete LUNs from the SecurePath' s active device list 



usage : 

autopath delete <device path | {option} {WWLUNID | Array Type}> 

device path : -- device special file e . g . /dev/dsk/c#t#d# 

option : 

-1 -- for entering the WWLUNID 

-r -- for entering the Array Type 

WWLUNID : — World Wide Node Name of the LUN 
Array Type: -- Array Type ( XP/VA/EVA-AA) 



autopath discover command 

The autopath discover command discovers any new devices or paths added, or any existing 
devices or paths deleted, and updates the data to the list of Secure Path for Active-Active devices. The 
virtual device special files gets created for all the discovered LUNs. 

The autopath discover command allows you to set he value (ON or OFF) to enable the automatic 
discovery of devices after reboot. The default value is set to OFF. 

Syntax: 

autopath discover [option] 
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Options : 

ON : Enable the auto discover devices feature 
OFF : Disable the auto discover devices feature 

Example: 

# autopath discover 

Discovery of New Paths / LUNs will be effective only if ioscan 
and insf -e are executed prior to autopath discover 
autopath: Initiating Autopath Discover... 
autopath: Discover in progress... 
autopath: Discover successful. 

# autopath discover ON 

AUTOPATH : Auto discover settings updated 



autopath retrieve command 

The autopath retrieve command restores the Secure Path load balancing policy, preferred path 
settings, and deleted LUNs across Secure Path upgrades. Retrieval of settings may not be effective if you 
have made SAN configuration changes for the host. Use the autopath retrieve command for 
retrieving persistence data after upgrade. 

Syntax: 

autopath retrieve 
Example: 

# autopath retrieve 

autopath setjbpolicy command 

The autopath set lbpolicy command sets the load balancing policy for the specified device path. 
Syntax: 

autopath set_lbpolicy <{policy name} {path}> 
description: sets load balancing policy 
usage : 

autopath set_lbpolicy <{policy name} {path}> 

Policy name: The load balancing policy to set 

Valid policies are 

RR : Round Robin. 

SST : Shortest Service Time. 

SQL : Shortest Queue Length. 

NLB/OFF : No load Balancing. 

Path : Device Special File e . g . /dev/dsk/c#t#d# 

Example: 

# autopath set_lbpolicy RR /dev/dsk/cOtOdO 

autopath set_prefpath command 

The autopath set prefpath command sets the preferred device path to a Secure Path device. 
When the path details are displayed with the autopath display command, the preferred path 
is marked (pp). 

Syntax: 
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autopath set_prefpath path 

The parameter path specifies the physical device path. 
Example: 

• autopath set_prefpath /dev/dsk/c4t0d0 

Troubleshooting Secure Path for Active-Active disk arrays 

You or on HP service representative can perform troubleshooting, depending upon your HP service 
contract. If you are unable to resolve an error condition, ask your HP service representative for assistance. 

This section describes the follov/ing: 

• Recovering after a failure 

• Secure Path messages 

Recovering after a failure 

When a path fails, it is no longer used by Secure Path. After the path is repaired. Secure Path 
automatically begins using the path with the designated load balancing policy. No user action is 
necessary. 



^ NOTE: 

If a path to the device has been serviced and the device recovery does not occur, check whether the 
autopath monitor process has been terminated inadvertently. If so, restart the recovery process by 
executing the autopath monitor command. 

For more information, see autopath monitor command. 

Secure Patfi messages 

Secure Path reports error, diagnostic messages, and informational messages to the 

/var/adm/syslog/syslog . log file. You can enter the dmesg command to view the messages 
reported by Secure Path. 

Table 13 lists the messages that may exist in the Secure Path log file. 

Table 13 Secure Path for Active-Active disk arrays event messages 



Event 


Syslog message 


DISCOVER RUNNING 


AUTOPATH : autopath discover command is 
already running on this host 


RETRIEVE RUNNING 


AUTOPATH : autopath retrieve command is 
already running on this host 


MONITOR RUNNING 


AUTOPATH : autopath monitor daemon is 
already running on this host 


INVALID DEVICE PATH 


AUTOPATH : invalid device path entered 


lOCTL FAILURE 


AUTOPATH : command failed 


NOT AN AUTOPATH DEVICE 


AUTOPATH : not a valid Secure Path 
device 


NO AUTOPATH DEVICE 


AUTOPATH : no Secure Path device found 


SET POLICY SUCCESS 


AUTOPATH : load balance policy set 
successfully for 0xlf040000 
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Event 


C 1 

Syslog message 


SET NEXT PATH AS PREF PATH 


AUTOPATH : path is not up, so the next 
active path is set as Preferred Path 


SET PREFERRED PATH SUCCESS 


AUTOPATH : Preferred Path set 
successfully for 0xlf040000 


NO ALTERNATE LINKS PRESENT 


AUTOPATH : no alternate links present 


MONITOR lOCTL FAILED 


AUTOPATH : monitor command failed 


INVALID DEVICE ENTRY 


AUTOPATH : invalid device entry 


INVALID LB POLICY 


AUTOPATH : invalid load balancing 
policy 


DEVICE OPEN FAILED 


AUTOPATH : device open failed 


DEVICE BUSY 


AUTOPATH : device busy 


MEMORY ALLOCATION FAILURE 


7iUTO?7\TI; : noL enouqh iT.eiT.ory 


DISCOVER IN PROGRESS 


AUTOPATH: autopath discover is in 
progress. please try later 


DELETE IN PROGRESS 


AUTOPATH: autopath delete is in 
progress. please try later 


ALL LUNS DELETED 


AUTOPATH : LUNs in this array are not 
configured under SecurePath control 


AUTOPATH DRIVER NOT FOUND 


AUTOPATH : HPswsp component missing or 

corrupted 


FILE OPEN FAILED 


AUTOPATH : file open failed 


FILE READ FAILED 


AUTOPATH : file read failed 


FILE WRITE FAILED 


AUTOPATH : file write failed 


FILE SEEK FAILED 


AUTOPATH : file seek pointer movement 
failed 


FILE NOT FOUND 


AUTOPATH: persistence file not found or 
corrupted. Command cannot proceed 


FILE NOT FOUND CREATING NEW 


AUTOPATH: persistence file not found. 
Proceeding to create one 


FILE UPDATE DONE 


AUTOPATH : persistence file updation 
done successfully 


FILE OPERATIONS FAILED 


AUTOPATH: persistence file operations 
failed. Hence persistence could not be 
retrieved 


UNINSTALL IN PROGRESS 


AUTOPATH: un-install in progress. 

Aborting the command execution 


UNINSTALL ABORT 


AUTOPATH: cannot un - install hpap 
module, one of the paths on which I/O / 
Open was issued originally is failed 


UNINSTALL ABORT 


AUTOPATH: Cannot un - install hpap 
module. The following Device (s) have 
I/O' s Queued 


DEVICE ACCESS FAILED MESSAGE 


AUTOPATH : Warning: Unable to access 
device 


MAXIMUM LUN COUNT REACHED MESSAGE 


AUTOPATH: Warning: LUN count reached 
maximum value of %d. Last device 
recognised is 
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Event 


Syslog message 


MAXIMUM PATH rOlINT RFAChlFD MF<^<^AGF 


AUTOPATH: Warning: Cannot add path 
0xlf040000 as an alternate link. Path 
count to end device reached maximum 

value of 0xlf040000 


ULM REGISTER FAILED MESSAGE 


AUTOPATH: Warning: Cannot register 
path 0xlf040000 as an Auto Path device. 
Path is already registered 


PATH FAILED MESSAGE 


AUTOPATH: Path 0xlf040000 failed! 
Rerouting to alternate path 


ALL PATHS FAILED MESSAGE 


AUTOPATH : All the paths to the end 
device 0xlf040000 failed 


PATH RECOVERED MESSAGE 


AUTOPATH : Path 0xlf040000 recovered 


DD DEVICE BUSY 


AUTOPATH : Device Busy : 0xlf040000 


LUN COLLISION 


AUTOPATH : LUN collision occurred at 
Oxlf 040000 


DRIVER REGISTRATION FAILURE 


AUTO PATH: Warning: Could not Install 
HPAP Driver ret = 0xlf040000 


DATA STRUCTURE INITIALIZATION FAILURE 


AUTOPATH: data structure initialization 

failed 


DRIVER DE-REGISTRATION FAILURE 


AUTOPATH: Failure in Uninstalling HPAP 
0. r i e r 
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Secure Path for Active-Active disk arrays 



Glossary 



This glossary defines terms used in this guide or related to this product and is not a comprehensive 
glossary of computer terms. 



controller 



controller states 



device states 



fabric 



HBA 



LUN 



path 

path states 



port a 

SAN 
state 



A controller is a hardware device that facilitates communication betv/een a host and 
one or more LUNs organized as an array. The HSG80 and HSVllO controllers 
are supported for use with Secure Path. 

• critical-Reported for a controller pair bound in multi-bus failover mode when 
only one of the controllers is available. This state may mean a failed or offline 
condition, since the server cannot communicate with the other controller at this 
time. 

• operational-The controller is available with a good status. 

• unknown-The server cannot communicate with this controller. 

Attributes that describe the current operational condition of a device. A device 
may exist in the following states: 

• critical-Only one path remains available to the storage unit. 

• degraded-At least one or more paths are failed to the storage unit. 

• operational-The Secure Path device can be accessed on at least one path. 

• unknown-Unable to communicate with the unit. This may indicate no available 
path or a failed device. 

• dead-All paths used by this Secure Path device have failed. 

A network composed of high-speed fiber connections resulting from the 
interconnection of switches and devices. A fabric is an active and intelligent 
non-shared interconnect scheme for nodes. 

A Host Bus Adapter is an I/O device that serves as the interface connecting a host 
system to the SAN (Storage Area Network). 

A Logical Unit Number is the actual unit number assigned to a device at the RAID 
system controller. 

A virtual communication route that enables data and commands to pass between a 
host server and a storage device. 

• active - Currently used for the I/O stream. 

• available - Available on the active controller for the I/O stream. 

• failed - Currently unusable for the I/O stream. 

• quiesced - Path is valid but the user has moved all I/O from it. 

• standby - The path is valid on the standby controller. 

The relative number of an HBA. A specific port number is determined according to 
its order of discovery by the Windows operating system and includes SCSI, Fibre 
Channel, and IDE adapter types. 

Storage Area Network. A configuration of networked devices for storage. 

State is an attribute that describes the current operational condition of an object. 
See also Path, Path States, Controller States, and Device States. 
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Index 



Symbols 

# spmgr 

add WWLUNID, 60, 60 

client add, 64 

client delete, 64 

display (default), 40 

display -s, 46 

display -u, 46 

log -c, 50 

log -I, 50 

log -n, 50, 50 

notify, 52 

notify add, 51 

notify delete, 52 

password, 65 

quiesce - a controller, 57 

quiesce ■ a HBA, 57 

quiesce ■ c controller, 57 

quiesce ■ c pathjnstance, 58 

quiesce - p pathjnstance, 58 

refreshdisplay, 47 

restart -p pathjnstance, 59 

restart -a HBA, 59 

restart -c controller, 58 

restart -p pathjnstance, 59 

restore all, 57 

restore all paths to device, 57 
restore all paths to storage system, 56 
select -c controller_serial_number, 53 
select -p pathjnstance, 53 
set -f, 50 
set -p, 49 

verifying a path, 18 



active paths and load balancing, 55 
active state, 38 
adding 
LUNs, 59 

Secure Path to an existing configuration, 21 

SP to an existing RA/MA8000 or 

ESA/EMA12000 Configuration, 21 

WWLUNID, 60, 60 
addresses 

delete, 52 

display, 52 

notify, 51 , 52, 52 
alias 

defining, 47 

displaying, 48 
array configuration documenation, 22 
available state, 38 



commands 

autopath discover, 89 

autopath display, 82 

autopath help, 88 

autopath retrieve, 90 

autopath setjbpolicy, 90 

autopath set_prefpath, 90 

display, 40, 40 

log, 50 

notify, 51 

set, 48 

spmgr, 34 
configuration information, displaying, 37 
configuration tool, 16 
console, logging, 50 
controllers 

preferring a unit, 25 

quiesce, 57 

restart -cxll xll spmgr, 58 
states 

critical, 37 

operational, 37 
critical state, 37 

D 

defining 

alias, 47 

unalias, 47 
deleting LUNs, adding and, 59 
device states, 38 
display -s, # spmgr, 46 
display -u, # spmgr, 46 
display command, 40 

# spmgr, 40 

log settings, 50 
displaying 

alias, an, 48 

configuration information, 37 

path states, 44 
documentation, array configuration, 22 
drivers 

HPsv/sp, 79 

hsx, 15 

sdisk, 23 

swsp, 15 
dual RAID controllers, 15 



enable notification, logging, 50 
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enterprise virtual array 
array, configuring, 26 
HSV element manager, 26 
upgrading Secure Path, 66 

EVA3000, overview, 13 

EVA5000, overviev/, 13 

F 

failback options, 18 
failed state, 38 
failover, 17, 75 
fcmsutil utility, 20 

H 

hardware setup, HSx, 19 
HBA 

restart -a, xll # spmgr, 59 
restart -a, xll # spmgr, 59 

HP 

Subscriber's choice web site, 11 
HP SD utility, 78 
HPswsp driver, 79 
HSx 

installing software, 31 
removing software, 65 
SAN boot device, 33 
upgrading software, 66 
hsx driver, 71 

I 

installation 

silent, 17 
installing 

HSx software, 31 

new HSx configuration, 20 

on an HSx SAN boot device, 33 

on an xp boot device, 77 

remote management, 64 

xp software, 77 
installing 

Multipathing software, 15 
ioscan 

commands, 30 

running, 60 

L 

load balancing, 18, 48, 75 

active paths, 55 
load distribution 

described, 18 

disabled, 17 

enabled, 17 
log command, 50 

console, 50 

enable, 50 

settings display, 50 



LUNS 

adding and deleting, 59 
restoring, 57 

M 

management tools, 16 
multiple-bus mode, 14 

N 

notification, 50, 50 
notification severity levels, 51 
notify 

add, 51 

address, 51 

command, 51 

delete address, 52 

display addresses, 52 

o 

offline state, 38 
operational state, 37 
optional array features, 23 



path 

definition 

management behavior, 19 

verification, 18 
management, 52 

management behavior summary, 19 
selecting, controller_serial_number, 53 
states, 37 
verification 

defined, 18 

interval, setting, 50 

parameters, 48 

setting, 49 
path_instance 
quiesce, 58 

restart -p xll xll # spmgr, 59 
select, 53 
paths 

load balancing and active paths, 55 

restoring to device, 57 

restoring to storage system, 56 

selecting, 52 
PREFERRED_PATH unit attribute, 14 
preferring, unit to a controller, 25 

Q 

quiesce 

■a xll # spmgr, 57 

■c xll # spmgr, 57 

■p xll # spmgr, 58 
quiesced objects, restarting, 58 
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quiescing configuration objects, 57 

R 

refreshdisplay, # spmgr, 47 
related documentation, 10 
remote management, 64 
restarting quiesced objects, 58 
restore all 
LUNs, 57 

paths to device, 57 

paths to storage system, 56 



SAN boot device 
HSx, 33 
xp, 77 

SCSI Upper Layer Module (ULM), 75 
SCSI-2, using, 66 
SCSI-3, using, 25 
sdisk driver, 23 
Secure Path 

basic configuration, illustrated, 13 
HSx SAN boot device, 33 
installing 

HSx software, 31 
nev/ HSx configuration, 20 
xp SAN boot device, 77 
xp softv/are, 77 
overvievv, 13 
remote management, 64 
removing HSx softv/are, 65 
software components, 15 
spagent, 16 
spmgr, 16 

technical description, 13 

technology, 14 

uninstalling xp software, 79 

upgrading HSx software, 66 
selecting paths, 52 
services 

ULM, 75 
set commands, 48 

path 

verification interval, 50 

path verification, 49 

storage system parameters, 48 
setting up additional LUNs, 23 
severity levels, notification, 51 
spagent, 16, 71 



spmgr 
alias, 47 
commands, 34 
common terms, 36 
controller states, 37 
display -s, 46 
display -u, 46 
displaying an alias, 48 
log -c, 50 
log -I, 50 
log -n, 50, 50 
notify 

delete, 52 
notify add, 51 
notify display, 52 
overview, 34 
quiesce - a controller, 57 
quiesce ■ a HBA, 57 
quiesce ■ c controller, 57 
quiesce ■ p pathjnstance, 58 
refreshdisplay, 47 
remote management, 64 
restart -a HBA, 59 
restart -c controller, 58 
restart -p path_instance, 59 
restore all, 57 

restore all paths to device, 57 

restore all paths to storage system, 56 

select -p pathjnstance, 53 

select controller_serial_number, 53 

set path verification, 49 

set path verification interval, 50 

unalias, 47 
states 

controller, 37 

device, 38 

path, 37 

standby, 38 
storage system parameters, setting, 48 
Subscriber's choice, HP, 11 
swsp driver, 15 
syslog, 50 



T 

technical description of Secure Path, 13 
troubleshooting 

xp diagnostic messages, 91 
ttarget/LUNS per array comparison chart, 23 



u 

ULM services, 75 
unalias, defining, 47 
uninstalling 

HSx software, 65 

xp software, 79 
unit, preferring a controller, 25 
upgrading 

xp software, 78 
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utilities 

HP SD, 78 

w 

web sites 

HP Subscriber's choice, 11 
world wide name 

fcmsutil utility and, 20 

spmgr and, 49 



X 

xp 

command line interface, 79 
commands 

discover, 89 

display, 82 

help, 88 

retrieve, 90 

setjbpolicy, 90 

set_prefpath, 90 
device addition and deletion, 
diagnostic messages, 91 
failover, automatic, 75 
installing, 77 

path recovery, automatic, 75 
pro-active path, monitor, 76 
requirements, system, 76 
SAN boot device, 77 
uninstalling, 79 
upgrading software, 78 

xp 

load balancing, 75 
services, ULM, 75 
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